Identity Service API 안내서

Adobe Experience Platform Identity Service 는 Adobe Experience Platform 내에서 id 그래프로 알려진 것을 통해 고객의 크로스 디바이스, 크로스 채널 및 거의 실시간으로 식별하여 관리합니다.

시작하기

이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.

  • Identity Service: 고객 프로필 데이터의 단편화로 인해 발생하는 근본적인 문제를 해결합니다. 이는 고객이 브랜드와 상호 작용하는 디바이스 및 시스템 간에 ID를 연결하여 수행됩니다.
  • Real-Time Customer Profile: 여러 소스에서 집계한 데이터를 기반으로 통합 소비자 프로필을 실시간으로 제공합니다.
  • Experience Data Model (XDM): 표준화된 프레임워크 Platform 고객 경험 데이터를 구성합니다.

다음 섹션에서는 를 성공적으로 호출하기 위해 알고 있거나 보유하고 있어야 하는 추가 정보를 제공합니다. Identity Service API.

샘플 API 호출 읽기

이 안내서에서는 요청 형식을 지정하는 방법을 보여 주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 적절한 형식의 요청 페이로드가 포함됩니다. API 응답에서 반환되는 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용되는 규칙에 대한 자세한 내용은 의 섹션을 참조하십시오. 예제 API 호출을 읽는 방법 다음에서 Experience Platform 문제 해결 가이드.

필수 헤더에 대한 값 수집

을 호출하기 위해 Platform API, 먼저 다음을 완료해야 합니다. 인증 자습서. 인증 튜토리얼을 완료하면 아래와 같이 모든 Experience Platform API 호출의 필수 헤더 각각에 대한 값이 제공됩니다.

  • 인증: 전달자 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

의 모든 리소스 Experience Platform 특정 가상 샌드박스로 격리됩니다. 에 대한 모든 요청 Platform API에는 작업이 수행될 샌드박스의 이름을 지정하는 헤더가 필요합니다.

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
의 샌드박스에 대한 자세한 내용 Platform, 다음을 참조하십시오. 샌드박스 개요 설명서.

페이로드(POST, PUT, PATCH)가 포함된 모든 요청에는 추가 헤더가 필요합니다.

  • Content-Type: application/json

지역 기반 라우팅

다음 Identity Service API는 를 포함해야 하는 지역별 종단점을 사용합니다. {REGION} 을 요청 경로의 일부로 사용합니다. 조직을 프로비저닝하는 동안 영역은 조직 프로필 내에서 결정되고 저장됩니다. 각 끝점에 올바른 영역을 사용하면 를 사용하여 이루어진 모든 요청이 Identity Service API는 적절한 지역으로 라우팅됩니다.

현재 이 지원하는 두 개의 지역이 있습니다. Identity Service API: VA7 및 NLD2.

아래 표는 영역을 사용하는 경로의 예를 보여줍니다.

서비스
지역: VA7
지역: NLD2
Identity Service API
https://platform-va7.adobe.io/data/core/identity/
https://platform-nld2.adobe.io/data/core/identity/
Identity Namespace API
https://platform-va7.adobe.io/data/core/idnamespace/
https://platform-nld2.adobe.io/data/core/idnamespace
NOTE
영역을 지정하지 않고 요청하면 잘못된 영역으로 라우팅되는 호출이 발생하거나 예기치 않게 호출이 실패할 수 있습니다.

조직 프로필 내에서 지역을 찾을 수 없는 경우 시스템 관리자에게 지원을 요청하십시오.

사용 Identity Service API

이러한 서비스에 사용되는 ID 매개 변수는 복합 또는 XID 중 한 가지 방법으로 표현할 수 있습니다.

복합 ID는 ID 값과 네임스페이스를 모두 포함하는 구문입니다. 복합 ID를 사용할 때 네임스페이스는 다음 이름 중 하나로 제공될 수 있습니다. (namespace.code) 또는 ID(namespace.id).

ID가 지속되면 Identity Service 는 네이티브 ID 또는 XID라고 하는 ID를 생성하여 해당 ID에 할당합니다. 모든 클러스터 및 매핑 API 변형은 해당 요청 및 응답에서 복합 ID와 XID를 모두 지원합니다. 매개 변수 중 하나가 필요합니다. xid 또는 복합물 [ns 또는 nsid] 및 id 를 클릭하여 다음 API를 사용하십시오.

응답에서 페이로드를 제한하기 위해 API는 사용한 ID 구문 유형에 대한 응답을 조정합니다. 즉, XID를 전달하는 경우 응답에는 XID가 생기고, 복합 ID를 전달하는 경우 응답은 요청에 사용된 구조를 따릅니다.

이 문서의 예제에서는 의 전체 기능을 다루지 않습니다 Identity Service API. 전체 API에 대한 자세한 내용은 Swagger API 참조.

NOTE
요청에 네이티브 XID를 사용하면 반환되는 모든 ID가 네이티브 XID 형식으로 표시됩니다. ID/네임스페이스 양식을 사용하는 것이 좋습니다. 자세한 내용은 다음 섹션 을 참조하십시오 id에 대한 XID를 가져오는 중.

다음 단계

필요한 자격 증명을 수집했으므로 이제 나머지 개발자 안내서를 계속 읽을 수 있습니다. 각 섹션에서는 해당 끝점에 대한 중요한 정보를 제공하고 CRUD 작업을 수행하기 위한 예제 API 호출을 보여줍니다. 각 호출에는 일반 API 형식, 필요한 헤더와 올바른 형식의 페이로드를 보여주는 샘플 요청 및 성공적인 호출을 위한 샘플 응답이 포함됩니다.

recommendation-more-help
64963e2a-9d60-4eec-9930-af5aa025f5ea