Platform FAQ 및 문제 해결 안내서

마지막 업데이트: 2023-11-15
  • 작성 대상:
  • Developer
    User
    Admin
    Leader

이 문서에서는 Adobe Experience Platform에 대해 자주 묻는 질문에 대한 답변과 함께 다음 항목에서 발생할 수 있는 일반적인 오류에 대한 높은 수준의 문제 해결 안내서를 제공합니다 Experience Platform API. 개인에 대한 문제 해결 안내서의 경우 Platform 서비스, 다음을 참조하십시오. 서비스 문제 해결 디렉터리 아래요.

FAQ

다음은 Adobe Experience Platform에 대한 FAQ 응답 목록입니다.

이란? Experience Platform API?

Experience Platform 은 HTTP 요청을 사용하여 액세스하는 여러 RESTful API를 제공합니다 Platform 리소스. 이러한 서비스 API는 각각 여러 끝점을 노출하며, 이를 통해 리소스를 나열(GET), 조회(GET), 편집(PUT 및/또는 PATCH), 삭제(DELETE) 작업을 수행할 수 있습니다. 각 서비스에 사용할 수 있는 특정 엔드포인트 및 작업에 대한 자세한 내용은 API 참조 설명서 Adobe I/O.

API 요청을 포맷하려면 어떻게 합니까?

요청 형식은 다음에 따라 다릅니다. Platform 사용 중인 API입니다. API 호출을 구성하는 방법을 가장 잘 알아보려면, 해당 API 호출에 대한 설명서에 제공된 예제를 따르십시오 Platform 사용 중인 서비스.

API 요청 형식에 대한 자세한 내용은 Platform API 시작 안내서를 참조하십시오. 샘플 API 호출 읽기 섹션.

내 조직이란?

조직은 고객을 Adobe으로 표현한 것입니다. 라이센스가 부여된 모든 Adobe 솔루션은 이 고객 조직과 통합됩니다. 조직에 권한이 부여된 경우 Experience Platform, 개발자에게 액세스 권한을 할당할 수 있습니다. 조직 ID(x-gw-ims-org-id)는 API 호출을 실행해야 하는 조직을 나타내며 모든 API 요청에서 헤더로 필요합니다. 이 ID는 Adobe Developer 콘솔: 통합 탭에서 다음 위치로 이동 개요 섹션에서 ID를 찾기 위한 특정 통합에 대한 섹션 클라이언트 자격 증명. 에서 인증하는 방법에 대한 단계별 연습 Platform, 다음을 참조하십시오. 인증 자습서.

API 키는 어디에서 찾을 수 있습니까?

API 키는 모든 API 요청의 헤더로 필요합니다. 다음을 통해 찾을 수 있습니다. Adobe Developer 콘솔. 콘솔 내에서 통합 탭에서 다음 위치로 이동 개요 특정 통합에 대한 섹션으로 이동하여 클라이언트 자격 증명. 인증 방법에 대한 단계별 연습: Platform, 다음을 참조하십시오. 인증 자습서.

액세스 토큰을 얻는 방법

모든 API 호출의 인증 헤더에 액세스 토큰이 필요합니다. 조직의 통합에 액세스할 수 있는 경우 CURL 명령을 사용하여 생성할 수 있습니다. 액세스 토큰은 24시간 동안만 유효하며, 그 이후에는 API를 계속 사용하려면 새 토큰을 생성해야 합니다. 액세스 토큰 생성에 대한 자세한 내용은 인증 자습서.

쿼리 매개 변수는 어떻게 사용합니까?

일부 Platform API 끝점은 쿼리 매개 변수를 사용하여 특정 정보를 찾고 응답에서 반환되는 결과를 필터링합니다. 쿼리 매개 변수는 물음표()가 있는 요청 경로에 추가됩니다?) 기호 뒤에 형식을 사용하는 하나 이상의 쿼리 매개 변수가 옵니다. paramName=paramValue. 단일 호출에서 여러 매개 변수를 결합할 때는 앰퍼샌드(&)을 클릭하여 개별 매개 변수를 분리할 수 있습니다. 다음 예는 여러 쿼리 매개 변수를 사용하는 요청이 설명서에 표시되는 방법을 보여 줍니다.

일반적으로 사용되는 쿼리 매개 변수의 예는 다음과 같습니다.

GET /tenant/schemas?orderby=title
GET /datasets?limit=36&start=10
GET /batches?createdAfter=1559775880000&orderBy=desc:created

특정 서비스 또는 끝점에 사용할 수 있는 쿼리 매개 변수에 대한 자세한 내용은 서비스별 설명서를 참조하십시오.

PATCH 요청에서 업데이트할 JSON 필드를 어떻게 표시합니까?

의 많은 PATCH 작업 Platform API 사용 JSON 포인터 업데이트할 JSON 속성을 나타내는 문자열입니다. 일반적으로 다음을 사용하여 요청 페이로드에 포함됩니다. JSON 패치 포맷. 다음을 참조하십시오. API 기본 사항 안내서 이러한 기술에 필요한 구문에 대한 자세한 정보입니다.

Postman을 사용하여 Platform API?

Postman 는 RESTful API에 대한 호출을 시각화하는 데 유용한 도구입니다. 다음 Platform API 시작 안내서 Postman 컬렉션 가져오기에 대한 비디오 및 지침이 포함되어 있습니다. 또한 각 서비스에 대한 Postman 컬렉션 목록이 제공됩니다.

에 대한 시스템 요구 사항은 무엇입니까? Platform?

UI 또는 API 사용 여부에 따라 다음 시스템 요구 사항이 적용됩니다.

UI 기반 작업의 경우:

  • 최신 표준 웹 브라우저입니다. 최신 버전의 Chrome 권장됨, 현재 및 이전의 주요 릴리스 Firefox, Internet Explorer및 Safari도 지원됩니다.
    • 새로운 주요 버전이 릴리스될 때마다 Platform 에서는 세 번째 최신 버전에 대한 지원이 삭제되는 동안 가장 최근 버전을 지원합니다.
  • 모든 브라우저에는 쿠키와 JavaScript가 활성화되어 있어야 합니다.

API 및 개발자 상호 작용:

  • REST, 스트리밍 및 Webhook 통합을 위해 개발할 개발 환경입니다.

오류 및 문제 해결

다음은 를 사용할 때 발생할 수 있는 오류 목록입니다 Experience Platform 서비스. 개인에 대한 문제 해결 안내서의 경우 Platform 서비스, 다음을 참조하십시오. 서비스 문제 해결 디렉터리 아래요.

API 상태 코드

다음 상태 코드는 다음에서 찾을 수 있습니다. Experience Platform API. 각각은 다양한 원인을 가지고 있으므로, 이 절에서 설명하는 내용은 본질적으로 일반적이다. 개인의 특정 오류에 대한 자세한 내용 Platform 서비스, 다음을 참조하십시오. 서비스 문제 해결 디렉터리 아래요.

상태 코드 설명 가능한 원인
400 잘못된 요청 요청이 잘못 구성되었거나, 키 정보가 누락되었거나, 잘못된 구문이 들어 있습니다.
401 인증 실패 요청이 인증 검사를 통과하지 못했습니다. 액세스 토큰이 누락되었거나 유효하지 않을 수 있습니다. 다음을 참조하십시오. OAuth 토큰 오류 자세한 내용은 아래 섹션을 참조하십시오.
403 금지 리소스를 찾았지만 볼 수 있는 자격 증명이 없습니다.
이 오류의 가능한 원인은 필요한 항목이 없을 수 있기 때문입니다 액세스 제어 권한 을 클릭하여 리소스에 액세스하거나 리소스를 편집합니다. 방법 읽기 필요한 속성 기반 액세스 제어 권한 얻기 Platform API를 사용합니다.

404 찾을 수 없음 요청한 리소스를 서버에서 찾을 수 없습니다. 리소스가 삭제되었거나 요청한 경로가 잘못 입력되었을 수 있습니다.
500 내부 서버 오류 서버측 오류입니다. 여러 번 동시에 호출하는 경우 API 제한에 도달하고 결과를 필터링해야 할 수 있습니다. (다음을 참조하십시오. Catalog Service 에 대한 API 개발자 안내서 하위 안내서 데이터 필터링 자세히 알아보십시오.) 요청을 다시 시도하기 전에 잠시 기다린 후 문제가 지속되면 관리자에게 문의하십시오.

요청 헤더 오류

의 모든 API 호출 Platform 특정 요청 헤더 필요. 개별 서비스에 필요한 헤더를 확인하려면 다음을 참조하십시오. API 참조 설명서. 필요한 인증 헤더에 대한 값을 찾으려면 다음을 참조하십시오. 인증 자습서. API 호출을 수행할 때 이러한 헤더가 누락되거나 유효하지 않은 경우 다음 오류가 발생할 수 있습니다.

OAuth 토큰이 누락되었습니다

{
    "error_code": "403010",
    "message": "Oauth token is missing."
}

이 오류 메시지는 Authorization API 요청에서 헤더가 누락되었습니다. 인증 헤더가 유효한 액세스 토큰에 포함되어 있는지 확인한 후 다시 시도하십시오.

OAuth 토큰이 잘못되었습니다.

{
    "error_code": "401013",
    "message": "Oauth token is not valid"
}

이 오류 메시지는 입력한 액세스 토큰이에 Authorization 헤더가 잘못되었습니다. 토큰이 올바르게 입력되었는지 확인합니다. 또는 새 토큰 생성 Adobe I/O 콘솔에서 게시할 수 있습니다.

API 키가 필요합니다.

{
    "error_code": "403000",
    "message": "Api Key is required"
}

이 오류 메시지는 API 키 헤더(x-api-key)이 API 요청에서 누락되었습니다. 헤더가 유효한 API 키에 포함되어 있는지 확인한 후 다시 시도하십시오.

API 키가 잘못되었습니다.

{
    "error_code": "403003",
    "message": "Api Key is invalid"
}

이 오류 메시지는 제공된 API 키 헤더의 값(x-api-key)이(가) 잘못되었습니다. 키를 올바르게 입력했는지 확인한 후 다시 시도하십시오. API 키를 모를 경우 Adobe I/O 콘솔: 통합 탭에서 다음 위치로 이동 개요 아래에서 API 키를 찾는 특정 통합에 대한 섹션 클라이언트 자격 증명.

헤더 누락

{
    "error_code": "400003",
    "message": "Missing header"
}

이 오류 메시지는 조직 헤더(x-gw-ims-org-id)이 API 요청에서 누락되었습니다. 헤더가 조직의 ID에 포함되어 있는지 확인한 후 다시 시도하십시오.

프로필이 잘못되었습니다.

{
    "error_code": "403025",
    "message": "Profile is not valid"
}

이 오류 메시지는 사용자 또는 Adobe I/O 통합( 액세스 토큰 다음에서 Authorization 헤더)는 (으)로 호출할 권한이 없습니다. Experience Platform 에 제공된 조직의 API x-gw-ims-org-id 머리글입니다. 헤더에 조직에 대한 올바른 ID를 입력했는지 확인한 후 다시 시도하십시오. 조직 ID를 모를 경우 Adobe I/O 콘솔: 통합 탭에서 다음 위치로 이동 개요 섹션에서 ID를 찾을 수 있습니다. 클라이언트 자격 증명.

Etag 새로 고침 오류

{
"errorMessage":"Supplied version=[\\\\\\\"a200a2a3-0000-0200-0000-123178f90000\\\\\\\"] does not match the current version on entity=[\\\\\\\"a200cdb2-0000-0200-0000-456179940000\\\\\\\"]"
}

다른 API 호출자가 흐름, 연결, 소스 커넥터 또는 타겟 연결과 같은 소스 또는 대상 엔티티를 변경한 경우 etag 오류가 발생할 수 있습니다. 버전 불일치로 인해 수행하려는 변경 사항이 최신 버전의 엔티티에 적용되지 않습니다.

이 문제를 해결하려면 엔티티를 다시 가져오고 변경 사항이 새 버전의 엔티티와 호환되는지 확인한 다음 새 태그를 If-Match 헤더를 반환하고 마지막으로 API를 호출합니다.

유효한 콘텐츠 유형이 지정되지 않음

{
    "type": "/placeholder/type/uri",
    "status": 400,
    "title": "BadRequestError",
    "detail": "A valid content-type must be specified"
}

이 오류 메시지는 POST, PUT 또는 PATCH 요청에 잘못되었거나 누락된 경우 표시됩니다 Content-Type 머리글입니다. 헤더가 요청에 포함되어 있는지 그리고 헤더 값이 인지 확인합니다. application/json.

사용자 영역이 누락되었습니다.

{
    "error_code": "403027",
    "message": "User region is missing"
}

이 오류 메시지는 아래 두 가지 경우 중 하나에 표시됩니다.

  • 조직 ID 헤더가 잘못되었거나 잘못된 경우(x-gw-ims-org-id)가 API 요청에서 전달됩니다. 조직의 올바른 ID가 포함되어 있는지 확인한 후 다시 시도하십시오.
  • 제공된 인증 자격 증명으로 표시된 계정이 Experience Platform을 위한 제품 프로필과 연결되어 있지 않은 경우. 의 단계를 따릅니다. 액세스 자격 증명 생성 플랫폼 API 인증 자습서에서 플랫폼을 계정에 추가하고 인증 자격 증명을 적절하게 업데이트합니다.

서비스 문제 해결 디렉터리

다음은 문제 해결 안내서 및 API 참조 설명서 목록입니다. Experience Platform API. 각 문제 해결 안내서는 FAQ에 대한 답변과 개인별 문제에 대한 솔루션을 제공합니다 Platform 서비스. API 참조 문서는 각 서비스에 대해 사용 가능한 모든 끝점에 대한 포괄적인 안내서를 제공하며, 받을 수 있는 샘플 요청 본문, 응답 및 오류 코드를 보여 줍니다.

서비스 API 참조 문제 해결
액세스 제어 액세스 제어 API 액세스 제어 문제 해결 안내서
Adobe Experience Platform 데이터 수집 Batch Ingestion API 일괄 처리 수집 문제 해결 안내서
Adobe Experience Platform 데이터 수집 Streaming Ingestion API 스트리밍 수집 문제 해결 안내서
Adobe Experience Platform 데이터 과학 작업 영역 Sensei Machine Learning API Data Science Workspace 문제 해결 안내서
Adobe Experience Platform 데이터 거버넌스 Policy Service API
Adobe Experience Platform ID 서비스 Identity Service API Identity Service 문제 해결 안내서
Adobe Experience Platform 쿼리 서비스 Query Service API Query Service 문제 해결 안내서
Adobe Experience Platform 세그멘테이션 Segmentation API
Catalog Service Catalog Service API
Experience Data Model (XDM) Schema Registry API XDM System FAQ 및 문제 해결 안내서
Flow Service (Sources 및 Destinations) Flow Service API
Real-Time Customer Profile Real-Time Customer Profile API Profile 문제 해결 안내서
샌드박스 샌드박스 API 샌드박스 문제 해결 안내서

이 페이지에서는