Platform FAQ 및 문제 해결 안내서

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

FAQ faq

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

이란? Experience Platform API? what-are-experience-platform-apis

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

API 요청을 포맷하려면 어떻게 합니까? how-do-i-format-an-api-request

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

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

내 조직이란? what-is-my-ims-organization

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

API 키는 어디에서 찾을 수 있습니까? where-can-i-find-my-api-key

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

액세스 토큰을 얻는 방법 how-do-i-get-an-access-token

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

쿼리 매개 변수는 어떻게 사용합니까? how-do-i-user-query-parameters

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

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

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

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

PATCH 요청에서 업데이트할 JSON 필드를 어떻게 표시합니까? how-do-i-indicate-a-json-field-to-update-in-a-patch-request

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

Postman을 사용하여 Platform API? how-do-i-use-postman-to-make-calls-to-platform-apis

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

에 대한 시스템 요구 사항은 무엇입니까? Platform? what-are-the-system-requirements-for-platform

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

UI 기반 작업의 경우:

API 및 개발자 상호 작용:

오류 및 문제 해결 errors-and-troubleshooting

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

API 상태 코드 api-status-codes

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

요청 헤더 오류 request-header-errors

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

OAuth 토큰이 누락되었습니다 oauth-token-is-missing

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

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

OAuth 토큰이 잘못되었습니다. oauth-token-is-not-valid

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

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

API 키가 필요합니다. api-key-is-required

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

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

API 키가 잘못되었습니다. api-key-is-invalid

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

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

헤더 누락 missing-header

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

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

프로필이 잘못되었습니다. profile-is-not-valid

{
    "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 새로 고침 오류 refresh-etag-error

{
"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를 호출합니다.

유효한 콘텐츠 유형이 지정되지 않음 valid-content-type-not-specified

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

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

사용자 영역이 누락되었습니다. user-region-is-missing

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

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

서비스 문제 해결 디렉터리 service-troubleshooting-directory

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