오류 처리

Reactor API를 호출하는 동안 문제가 발생하면 다음 방법 중 하나로 오류가 반환될 수 있습니다.

  • 즉시 오류: 즉시 오류가 발생하는 요청을 수행할 때 발생한 일반적인 유형의 오류를 반영하는 HTTP 상태와 함께 API에서 오류 응답이 반환됩니다.
  • 지연된 오류: API 요청을 수행하면 지연된 오류(예: 비동기 활동)가 발생하는 경우 관련 리소스의 API meta.status_details 에서 오류가 반환될 수 있습니다.

오류 형식

오류 응답은 JSON:API 오류 사양을 따르며, 일반적으로 다음 구조를 준수합니다.

{
  "errors": [
    {
      "id": "8a5526da-ab12-4be9-b084-2efe537f388c",
      "status": "404",
      "code": "not-found",
      "title": "Record Not Found",
      "meta": {
        "request_id": "jfb0dQ2e0XVTkQ6AOfEJFfTDjguw9x3d"
      },
      "source": {
        "pointer": "/data"
      }
    }
  ]
}
속성 설명
id 문제의 특정 발생에 대한 고유 식별자입니다.
status 문자열 값으로 표시되는 이 문제에 적용할 수 있는 HTTP 상태 코드입니다.
code 문자열 값으로 표시되는 애플리케이션별 오류 코드입니다.
title 지역화를 위해 은(는)​을(를) 발생 항목에서 발생 항목으로 변경해서는 안 된다는 문제에 대한 간략한 사람이 읽을 수 있는 요약입니다.
detail 이 문제 발생에 대한 사람이 읽을 수 있는 설명입니다. title 과 같이 이 필드의 값은 현지화할 수 있습니다.
source 오류 소스에 대한 참조를 포함하는 객체(선택적으로 다음 멤버 중 하나 포함):
meta 오류에 대한 비표준 메타데이터가 포함된 객체입니다.

오류 참조

다음 표에는 API가 반환할 수 있는 다양한 오류가 나와 있습니다.

오류 제목 설명
authentication-failure IMS 액세스 토큰이 잘못되었습니다. 다시 로그인하면 새 액세스 토큰을 받을 수 있습니다. 또는 기술 계정의 경우 IMS 액세스 토큰에 대해 새 JWT를 생성하고 교체하십시오.
connection-refused 서버에 연결할 수 없습니다.
decrypt-bad-passphrase 제공된 암호로 데이터를 해독할 수 없습니다.
decrypt-failed 제공된 개인 키로 데이터 암호를 해독할 수 없습니다. 키가 로컬에서 작동하고 공백이 잘렸는지 확인하십시오.
decrypt-no-data 개인 키가 없으면 데이터 암호를 해독할 수 없습니다. 암호화된 개인 키를 제공하십시오.
delegate-descriptor-unresolved 확장에서 이 위임 설명자에 대한 예상 정의를 제공하지 않았습니다. 확장을 업데이트해야 할 수 있습니다.
deleted-resources 라이브러리에 추가하려는 리소스가 삭제되었습니다.
environment-in-use 환경은 한 번에 하나의 라이브러리에만 할당할 수 있습니다. 옵션 1은 다른 환경을 선택하는 것입니다. 옵션 2는 라이브러리를 다른 환경으로 이동하거나 라이브러리를 삭제하여 이 환경을 해제하는 것입니다.
environment-required 빌드를 만들려면 먼저 라이브러리에 환경이 할당되어 있어야 합니다.
extension-not-found 데이터 요소 또는 규칙 구성 요소를 정의하는 확장은 라이브러리에 포함되지 않습니다. 필요한 모든 확장이 라이브러리에 추가되었는지 확인합니다.
extension-package-path-error extension.json에 정의된 경로가 잘못 구성되었습니다.
extension-package-transform-definition-error 개체 속성에 대해 잘못된 변형을 정의했습니다. 각 객체 속성에는 하나의 변형이 정의될 수 있으며 파일 변형 또는 함수 변형이어야 합니다.
extension-package-zip-error ExtensionPackage의 압축을 풀거나 배포를 위해 파일을 지핑하는 동안 오류가 발생했습니다.
host-in-use 하나 이상의 환경에서 호스트를 사용하는 경우에는 삭제할 수 없습니다.
host-required 이 라이브러리에 지정된 환경에 올바른 호스트가 없습니다. 라이브러리에 지정된 환경을 확인합니다. 그런 다음 해당 환경에 유효한 호스트를 할당합니다.
host-type-error SFTP 호스트만 자격 증명을 확인한 후에 사용할 수 있어야 하므로 해당 호스트 유형에만 사전 테스트를 사용할 수 있습니다.
illegal-custom-code-transform customCode 변환은 사용할 수 없습니다. 함수나 파일 변형을 지정하십시오.
ims-not-authorized 계정을 인증하는 동안 알 수 없는 오류가 발생했습니다. 나중에 다시 시도하세요.
ims-session-error 로그인 세션에서 문제가 있습니다. 로그아웃한 후 다시 로그인하십시오.
internal-error 내부 오류가 발생했습니다. 잠시 기다렸다가 다시 시도하십시오. 문제가 계속되면 Client Care에 문의하십시오.
invalid-data_element 라이브러리에 잘못된 데이터 요소를 추가할 수 없습니다.
invalid-embed_code 올바른 포함 코드가 아니거나 개발 또는 스테이징 환경에 연결하려고 합니다. DTM(Dynamic Tag Management) 포함 코드는 프로덕션 환경에만 연결할 수 있습니다.
invalid-extension 잘못된 확장을 라이브러리에 추가할 수 없습니다.
invalid-extension_package_id 확장 패키지의 일부 개체 속성만 수정할 수 있습니다. 허용되지 않는 항목 중 하나를 수정하려고 했습니다.
invalid-new-owner-org-id 할당하려는 조직 ID가 올바른 조직 ID가 아닙니다.
invalid-org 활성 조직에 API에 대한 액세스 권한이 없습니다. 올바른 조직을 사용하고 있는지 확인합니다.
invalid-rule 라이브러리에 잘못된 규칙을 추가할 수 없습니다.
invalid-settings-syntax 설정 JSON을 구문 분석하는 동안 구문 오류가 발생했습니다.
library-file-not-found 확장.json에 정의된 필수 파일을 zip 패키지 내에서 찾을 수 없습니다.
minification-error 잘못된 코드 또는 ES6 코드로 인해 코드를 컴파일할 수 없습니다.
multiple-revisions 라이브러리에 각 리소스의 버전은 하나만 포함할 수 있습니다.
no-available-orgs 이 사용자 계정은 태그에 액세스할 수 있는 제품 프로필에 속해 있지 않습니다. 태그 권한이 있는 제품 프로필에 이 사용자를 추가하려면 Admin Console을 사용하십시오.
not-authorized 이 사용자 계정에는 이 작업을 수행하는 데 필요한 권한이 없습니다.
not-found 레코드를 찾을 수 없습니다. 검색하려는 개체 ID를 확인합니다.
not-unique 사용하려는 이름이 이미 사용 중입니다. 이 리소스의 경우 'name' 속성은 고유해야 합니다.
public-release-not-authorized 확장의 공개 릴리스는 launch-ext-dev@adobe.com에 의해 조정됩니다. 자세한 내용은 확장 릴리스에 있는 문서를 참조하십시오.
read-only 이 리소스는 읽기 전용이므로 수정할 수 없습니다.
session-timeout 사용자 세션이 만료되었습니다. 로그아웃한 후 다시 로그인하십시오.
sftp-authentication-failed SFTP 연결에 대해 인증이 실패했습니다.
sftp-connection-timeout SFTP 연결 시간이 초과되었습니다.
sftp-exception SFTP를 사용하여 서버에 연결하는 동안 예외가 발생했습니다.
sftp-status-exception 서버와 통신하려는 동안 SFTP 예외가 발생했습니다.
socket-error 서버와 통신하는 동안 소켓 오류가 발생했습니다.
ssh-disconnect SSH 세션 연결이 끊어졌습니다.
timeout-error 서버와의 연결 시간이 초과되었습니다.
unknown-error 예기치 않은 오류가 발생했습니다. 나중에 다시 시도하거나 고객 지원 센터에 전화를 걸어 사고 당시 수행한 작업을 설명할 수 있습니다.
unsupported-custom-code-language 지원되지 않는 사용자 지정 코드 언어가 제공되었습니다.
upgraded-extension-required 확장 업그레이드를 설치한 후에는 업그레이드가 프로덕션에 도달할 때까지 모든 라이브러리에 해당 확장을 포함해야 합니다. 유일한 예외는 확장이 아직 게시되지 않은 경우입니다.
upstream-build-required 이 라이브러리를 빌드하려면 먼저 업스트림 라이브러리에 대한 성공적인 빌드가 필요합니다.

이 페이지에서는