HTTP 상태 코드

MC API는 표준 HTTP 상태 코드를 사용하여 요청의 성공 또는 실패를 응답으로 표시합니다. 작업 설명에 달리 명시되지 않는 한 상태 코드 값에 대한 다음과 같은 일반적인 해석이 적용됩니다.

표 1. HTTP 상태 코드
HTTP 상태 코드 HTTP 상태 메시지 설명
2억 확인 요청이 완전히 성공했습니다. 요청 결과가 포함된 응답 본문이 제공됩니다.
204 컨텐츠 없음 요청이 완전히 성공했으며 추가 응답 정보가 제공되지 않습니다.
400 잘못된 요청 요청에 필수 입력이 누락되었거나 제공된 입력에 오류가 있거나 불필요한 입력이 포함되어 있습니다. 오류에 대한 추가 정보는 오류 응답 본문에서 추가 정보가 포함된 사유 코드와 함께 제공됩니다.
403 금지됨 여러 오류 조건이 이 상태 코드를 발생시킵니다:
  • 요청에 인증이 필요하지만 X-API-세션 헤더가 제공되지 않았거나, 헤더가 제공되었지만 세션 ID가 유효하지 않습니다.
  • API 요청이 인증된 사용자에게 요청된 작업을 수행할 권한이 없습니다.
404 찾을 수 없음 여러 오류 조건이 이 상태 코드를 발생시킵니다:
  • URI가 현존하는 리소스를 지정하지 않거나 API 사용자에게 객체 액세스 권한이 없는 리소스를 지정합니다.
  • URI는 현재 대체 MC이기 때문에 MC에서 지원하지 않는 리소스 또는 작업을 지정합니다.
405 허용되지 않은 메소드 요청이 지정된 URI에 유효하지 않은 HTTP 메서드를 지정합니다.
409 충돌 관리되는 리소스가 요청된 작업을 수행하기에 잘못된 상태(상태)에 있습니다. 오류에 대한 추가 정보는 오류 응답 본문에서 추가 정보가 포함된 사유 코드와 함께 제공됩니다.
412 리소스 수정 전제 조건에 실패했습니다. 클라이언트가 제공한 ETag와 서버 ETag가 일치하면 POST를 진행합니다. 그렇지 않으면 412 리소스 수정 오류가 발생합니다.
413 요청 본문이 너무 큼 요청에 너무 큰 요청 본문이 포함되어 있습니다.
4억 1,500만 명 지원되지 않는 매체 유형 요청의 Content-Type 헤더는 Web Services API에서 지원하지 않는 표현을 지정합니다.
500 내부 서버 오류 요청을 처리하는 동안 서버 오류가 발생했습니다.
501 구현되지 않음 요청은 서버에서 인식하지 못하는 HTTP 메소드를 지정합니다(모든 리소스에 대해).
503 서비스를 사용할 수 없음 일시적인 상황으로 인해 MC가 요청을 수행할 수 없었습니다.
505 HTTP 버전이 지원되지 않음 이 요청은 Web Services API에서 지원하지 않는 HTTP 프로토콜 버전을 지정합니다.