응답 메시지

Verify 애플리케이션 프로그래밍 인터페이스(API)에서 반환하는 다양한 오류 및 응답 메시지에 대한 정보.

HTTP 상태 코드는 오퍼레이션의 성공 여부를 표시합니다. API에 Verify 요청을 보내고 응답을 받을 때 다음과 같은 유형의 오류가 발생할 수 있습니다:
2xx 성공
오퍼레이션의 성공 상태를 표시합니다.
4xx 클라이언트 오류
클라이언트 애플리케이션이 제출한 요청의 문제를 표시합니다. 요청을 다시 제출하기 전에 요청에서 문제를 수정하십시오.
5xx 서버 오류
서버의 문제를 표시합니다. 성공할 때까지 요청을 다시 제출하거나 재시도하십시오.
응답 본문은 메시지 ID(messageId) 및 요청자 로케일로 번역되는 텍스트(messageDescription)를 포함합니다.
표 1. 응답 메시지
HTTP 상태 코드 설명
200 오브젝트 검색 성공
201 오브젝트 작성 성공
202 요청이 채택되었지만 완료되지 않았습니다(비동기 오퍼레이션).
204 오브젝트의 업데이트 또는 삭제와 같은 요청된 오퍼레이션이 완료되었습니다.
207 다중 상태(결과의 혼합)가 리턴되었습니다. 이 상태는 PATCH 및 벌크 오퍼레이션에서 발생할 수 있습니다.
400 잘못된 요청입니다. 요청이 잘못되었거나 처리할 수 없습니다. 입력 매개변수가 올바르지 않은 값을 포함하고 있을 수 있습니다.
401 클라이언트가 인증되지 않았습니다. 예를 들어, 사용된 액세스 토큰이 유효하지 않습니다.
403 금지된 액세스입니다. 예를 들어, 액세스 토큰이 요청된 리소스에 대한 액세스를 허용하지 않습니다.
404 자원을 찾을 수 없습니다. 요청 정보가 없습니다.
405 요청에서 지정된 HTTP 메소드가 리소스에서 지원되지 않습니다.
406 리소스가 요청의 채택 헤더에서 지정된 표시를 생성할 수 없습니다.
409 정보가 있습니다.
415 리소스가 요청의 컨텐츠 유형 헤더에서 지정된 표시를 이용할 수 없습니다.
429 요청이 너무 많음
500 요청을 처리하는 중에 내부 서버 오류가 발생했습니다.
501 요청된 메소드를 사용할 수 없습니다.
502 알림이 전송되지 않았습니다.
PATCH 오퍼레이션 중에 모든 오퍼레이션이 성공하면
204
상태가 리턴됩니다. 한 번 이상 실패한 경우 207 상태가 리턴되고 클라이언트에서 결과를 구문 분석할 수 있습니다.
DELETE또는 과 같은 POST 대량 관리 작업 중 모든 작업이 성공하면,
201
상태가 리턴됩니다. 한 번 이상 실패한 경우 207 상태가 리턴되고 클라이언트에서 결과를 구문 분석할 수 있습니다.

오류 처리를 위해 오류 응답 본문에서 HTTP 응답 코드 및 messageId를 사용하십시오. messageDescription은 정보용으로만 사용되며, 변경될 수 있습니다. 해당 변경사항은 API 시맨틱을 변경하지 않습니다.