자격 증명 구성 검색
platform.adobe.io/data/core/activation/authoring/credentials
이 페이지에서는 /authoring/credentials
API 끝점을 사용하여 자격 증명 구성을 검색하는 데 사용할 수 있는 API 요청 및 페이로드를 구현합니다.
/credentials
API 끝점을 사용해야 하는 경우 when-to-use
/credentials
을(를) 사용하지 할 필요가 없습니다. 대신 /destinations
끝점의 customerAuthenticationConfigurations
매개 변수를 통해 대상에 대한 인증 정보를 구성할 수 있습니다.Adobe과 대상 플랫폼 사이에 전역 인증 시스템이 있고 Platform 고객이 대상에 연결하기 위해 인증 자격 증명을 제공할 필요가 없는 경우에만 이 API 끝점을 사용하여 자격 증명 구성을 만드십시오. 이 경우 /credentials
API 끝점을 사용하여 자격 증명 구성을 만들어야 합니다.
글로벌 인증 시스템을 사용하는 경우 새 대상 구성을 만드는 경우에 대상 게재 구성에서 "authenticationRule":"PLATFORM_AUTHENTICATION"
을(를) 설정해야 합니다.
자격 증명 API 작업 시작 get-started
계속하기 전에 시작 안내서에서 필요한 대상 작성 권한 및 필수 헤더를 얻는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.
자격 증명 구성 검색 retrieve
/authoring/credentials
끝점에 대해 GET
요청을 수행하여 기존 자격 증명 구성을 검색할 수 있습니다.
API 형식
다음 API 형식을 사용하여 계정에 대한 모든 자격 증명 구성을 검색합니다.
GET /authoring/credentials
{INSTANCE_ID}
매개 변수로 정의된 특정 자격 증명 구성을 검색하려면 다음 API 형식을 사용하십시오.
GET /authoring/credentials/{INSTANCE_ID}
다음 두 요청은 요청에서 INSTANCE_ID
매개 변수를 전달하는지 여부에 따라 IMS 조직의 모든 자격 증명 구성 또는 특정 자격 증명 구성을 검색합니다.
아래에서 각 탭을 선택하여 해당 페이로드를 확인합니다.
accordion | ||
---|---|---|
요청 | ||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 사용한 IMS Org ID 및 샌드박스 이름을 기반으로 액세스 권한이 있는 자격 증명 구성 목록과 함께 HTTP 상태 200을 반환합니다. 하나의
|
accordion | ||||||||
---|---|---|---|---|---|---|---|---|
요청 | ||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공적인 응답은 요청에 제공된
|
API 오류 처리 error-handling
Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 플랫폼 문제 해결 안내서에서 API 상태 코드 및 요청 헤더 오류를 참조하십시오.
다음 단계 next-steps
이제 이 문서를 읽고 /authoring/credentials
API 끝점을 사용하여 자격 증명 구성에 대한 세부 정보를 검색하는 방법을 알게 되었습니다. Destination SDK을 사용하여 대상을 구성하는 방법을 읽고 대상 구성 프로세스에 이 단계가 어디에 맞는지 파악하십시오.