오류 코드

Marketo REST API는 HTTP, 응답 또는 레코드 수준에서 오류를 반환합니다. 이 페이지에서는 각 오류 유형에 대해 설명하고 관련 오류 코드를 나열합니다.

예외 처리 및 로깅

통합에서 예상치 못한 예외가 발생하면 요청 및 응답을 기록합니다. 만료된 인증과 같은 일부 예외는 재인증으로 처리할 수 있습니다. 다른 예외는 관련 요청 및 응답 세부 정보를 요청하는 지원 부서의 도움을 요청할 수 있습니다.

오류 유형

Marketo REST API는 일반 작업 중 세 가지 유형의 오류를 반환할 수 있습니다.

응답 수준 및 레코드 수준 오류는 HTTP 상태 코드 200을 반환합니다. 모든 오류 유형의 경우 HTTP 이유 구는 선택 사항이며 변경될 수 있으므로 평가하지 마십시오.

HTTP 수준 오류

일반 작업 중에 Marketo에서 두 개의 HTTP 상태 코드 오류(413 Request Entity Too Large 및 414 Request URI Too Long)를 반환합니다. 오류를 복구하려면 요청을 수정하고 다시 시도하십시오. 제출하기 전에 요청 크기를 확인하여 이러한 오류를 방지할 수 있습니다.

Marketo은 요청 페이로드가 1MB 또는 리드 가져오기의 경우 10MB를 초과하면 413을 반환합니다. 제출하기 전에 요청 크기를 확인하십시오. 레코드로 인해 요청이 한도를 초과하는 경우 해당 레코드를 다른 요청으로 이동합니다.

Marketo은 GET 요청의 URI가 8KB를 초과하면 414를 반환합니다. 제출하기 전에 쿼리 문자열 길이를 확인하십시오. 한도를 초과하면 요청 메서드를 POST로 변경하고 쿼리 문자열을 요청 본문에 넣고 _method=GET 매개 변수를 추가합니다. 긴 URI는 GUID와 같이 필터 값이 긴 큰 레코드 배치를 검색할 때 가장 일반적입니다.

일반적으로 클라이언트 ID 또는 클라이언트 암호가 잘못되었기 때문에 ID 끝점이 401 Unauthorized 오류를 반환할 수 있습니다. 다음 표에는 HTTP 수준 오류 코드가 나와 있습니다.

응답 수준 오류

응답이 success 매개 변수를 false로 설정할 때 응답 수준 오류가 발생합니다. 다음 구조를 사용합니다.

{
    "requestId": "e42b#14272d07d78",
    "success": false,
    "errors": [
        {
            "code": "601",
            "message": "Unauthorized"
        }
    ]
}

“오류” 배열의 각 객체에는 두 개의 멤버가 포함됩니다.

6xx 코드는 전체 요청이 실패하여 실행되지 않았음을 나타냅니다. 예를 들어, 요청을 사용하여 새 액세스 토큰을 다시 인증하고 전달하여 601 “유효하지 않은 액세스 토큰” 오류에서 복구합니다.

7xx 코드는 반환된 데이터가 없거나 요청 매개 변수가 잘못되었기 때문에 요청이 실패했음을 나타냅니다. 잘못된 날짜 또는 누락된 필수 매개 변수가 원인입니다.

응답 수준 오류 코드

레코드 수준 record_level_errors

레코드 수준 오류는 요청이 유효하지만 개별 레코드에 대한 작업을 완료할 수 없음을 나타냅니다. 레코드 수준 오류가 있는 응답은 다음 패턴을 따릅니다.

응답

{
   "requestId":"e42b#14272d07d78",
   "success":true,
   "result":[
      {
         "id":50,
         "status":"created"
      },
      {
         "id":51,
         "status":"created"
      },
      {
         "status":"skipped",
         "reasons":[
            {
               "code":"1005",
               "message":"Lead already exists"
            }
         ]
      }
   ]
}

결과 배열의 레코드는 요청 입력 배열의 레코드와 같은 순서로 나타납니다. 각 레코드는 상태 필드에 표시된 대로 독립적으로 성공하거나 실패할 수 있습니다.

실패한 레코드의 경우 “상태” 필드는 "건너뜀"이며 레코드에는 “원인” 배열이 포함됩니다. 각 이유에는 “code” 멤버와 “message” 멤버가 포함되어 있습니다. 코드는 항상 1xxx이며 메시지는 레코드가 생략된 이유를 설명합니다.

예를 들어, Sync Leads 요청에서 "action"을 "createOnly"로 설정하고 제출된 키 중 하나에 대한 리드가 이미 존재하는 경우 응답에서 위에 표시된 대로 코드 1005 및 “Lead already exists” 메시지를 반환합니다.

레코드 수준 오류 코드