Platform FAQ 및 문제 해결 가이드

이 문서에서는 Adobe Experience Platform과 관련하여 자주 묻는 질문에 대한 답변과 Experience Platform API에서 발생할 수 있는 일반적인 오류에 대한 고급 문제 해결 안내서를 제공합니다. 개별 Platform 서비스에 대한 문제 해결 가이드는 아래의 서비스 문제 해결 디렉토리를 참조하십시오.

FAQ

다음은 Adobe Experience Platform에 대한 질문과 답변 목록입니다.

Experience Platform API는 무엇입니까?

Experience Platform 리소스 액세스에 대한 HTTP 요청을 사용하는 여러 RESTful API를 Platform 제공합니다. 이러한 서비스 API는 각각 여러 끝점을 노출하며 목록(GET), 조회(GET), 편집(PUT 및/또는 PATCH), 리소스 삭제(DELETE) 등의 작업을 수행할 수 있도록 해줍니다. 각 서비스에 사용할 수 있는 특정 끝점 및 작업에 대한 자세한 내용은 Adobe I/O의 API 참조 설명서를 참조하십시오.

API 요청의 형식을 어떻게 지정합니까?

요청 형식은 사용 중인 Platform API에 따라 달라집니다. API 호출을 구조화하는 방법을 학습하는 가장 좋은 방법은 사용 중인 특정 Platform 서비스에 대한 설명서에 나와 있는 예제와 함께 따르는 것입니다.

API 요청 서식 지정에 대한 자세한 내용은 플랫폼 API 시작 안내서 샘플 API 호출 섹션을 참조하십시오.

IMS 조직이란 무엇입니까?

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

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

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

액세스 토큰은 어떻게 얻습니까?

액세스 토큰은 모든 API 호출의 인증 헤더에 필요합니다. IMS 조직에 대한 통합에 액세스할 수 있는 경우 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 필드를 어떻게 표시합니까?

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

Postman을 사용하여 Platform API를 호출할 수 있습니까?

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

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

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

UI 기반 작업의 경우:

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

API 및 개발자 인터랙션의 경우

  • REST, 스트리밍 및 웹 후크 통합을 위한 개발 환경입니다.

오류 및 문제 해결

다음은 Experience Platform 서비스를 사용할 때 발생할 수 있는 오류 목록입니다. 개별 Platform 서비스에 대한 문제 해결 가이드는 아래의 서비스 문제 해결 디렉토리를 참조하십시오.

API 상태 코드

Experience Platform API에서 다음 상태 코드가 나타날 수 있습니다. 각각 다양한 원인이 있기 때문에 이 섹션에서 설명한 내용은 일반적으로 자연적입니다. 개별 Platform 서비스의 특정 오류에 대한 자세한 내용은 아래 서비스 문제 해결 디렉토리를 참조하십시오.

| 상태 코드 | 설명 | 가능한 원인 |
— | — |

| 400 | 잘못된 요청 | 요청이 잘못 구성되었거나, 키 정보가 누락되었거나, 잘못된 구문이 포함되어 있습니다. |
| 401년 | 인증 실패 | 요청이 인증 검사를 통과하지 못했습니다. 액세스 토큰이 없거나 유효하지 않을 수 있습니다. 자세한 내용은 아래 OAuth 토큰 오류 섹션을 참조하십시오. |
| 403년 | 금지 | 리소스를 찾았지만 볼 수 있는 자격 증명이 없습니다. |
| 404년 | 찾을 수 없음 | 요청한 리소스를 서버에서 찾을 수 없습니다. 리소스가 삭제되었거나 요청한 경로가 잘못 입력되었을 수 있습니다. |
| 500 | 내부 서버 오류 | 서버 측 오류입니다. 동시에 여러 호출을 하는 경우 API 제한에 도달하고 결과를 필터링해야 할 수 있습니다. 자세한 내용은 데이터 필터링의 Catalog Service API 개발자 안내서 하위 가이드를 참조하십시오. 요청을 다시 시도하기 전에 잠시 기다린 후 문제가 지속되면 관리자에게 문의하십시오. |

요청 헤더 오류

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

OAuth 토큰이이(가) 없습니다.

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

이 오류 메시지는 API 요청에서 Authorization 헤더가 누락될 때 표시됩니다. 다시 시도하기 전에 권한 부여 헤더가 유효한 액세스 토큰에 포함되어 있는지 확인합니다.

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

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

이 오류 메시지는 Authorization 헤더에 제공된 액세스 토큰이 유효하지 않을 때 표시됩니다. 토큰이 올바르게 입력되었는지 확인하거나 Adobe I/O 콘솔에서 새 토큰을 생성합니다.

API 키가 필요합니다.

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

API 요청에서 API 키 헤더(x-api-key)가 누락되었을 때 이 오류 메시지가 표시됩니다. 헤더를 유효한 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"
}

이 오류 메시지는 API 요청에서 IMS 조직 헤더(x-gw-ims-org-id)가 누락되었을 때 표시됩니다. 다시 시도하기 전에 헤더가 IMS 조직의 ID에 포함되어 있는지 확인합니다.

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

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

이 오류 메시지는 사용자 또는 Adobe I/O 통합(Authorization 헤더에서 액세스 토큰으로 식별됨)이 x-gw-ims-org-id 헤더에서 제공하는 IMS 조직에 대해 Experience Platform API를 호출할 권한이 없는 경우에 표시됩니다. 다시 시도하기 전에 헤더에서 IMS 조직에 대한 올바른 ID를 제공했는지 확인하십시오. 조직 ID를 모를 경우 Adobe I/O 콘솔에서 찾을 수 있습니다.통합 탭에서 개요 섹션으로 이동하여 클라이언트 자격 증명​에서 ID를 찾습니다.

유효한 콘텐츠 형식을 지정하지 않았습니다.

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

이 오류 메시지는 POST, PUT 또는 PATCH 요청에 잘못된 헤더가 있거나 누락된 Content-Type 헤더가 있을 때 표시됩니다. 헤더가 요청에 포함되고 해당 값이 application/json인지 확인합니다.

서비스 문제 해결 디렉터리

다음은 Experience Platform API에 대한 문제 해결 가이드 및 API 참조 설명서 목록입니다. 각 문제 해결 안내서는 개별 Platform 서비스에 해당하는 문제에 대한 질문과 해결 방법을 제공합니다. API 참조 문서는 각 서비스에 대해 사용 가능한 모든 끝점에 대한 포괄적인 안내서를 제공하고 사용자가 받을 수 있는 샘플 요청 본문, 응답 및 오류 코드를 표시합니다.

서비스 API 참조 문제 해결
액세스 제어 액세스 제어 API 액세스 제어 문제 해결 가이드
Adobe Experience Platform 데이터 통합 Data 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 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 샌드박스 문제 해결 안내서

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now