HTTP 상태 코드

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

표 1. HTTP 상태 코드
HTTP 상태 코드	HTTP 상태 메시지	설명
2억	확인	요청이 완료되었습니다. 요청의 결과를 포함하는 응답 본문이 제공됩니다.
204	컨텐츠 없음	요청이 완전히 성공했으며 추가 응답 정보가 제공되지 않습니다.
400	잘못된 요청	요청에 필수 입력이 누락되었거나 제공된 입력에 오류가 있거나 관련 없는 입력이 포함되었습니다. 오류에 관한 추가 정보는 추가 정보와 함께 이유 코드를 포함하는 오류 응답 본문에 제공됩니다.
403	금지됨	다중 오류 조건으로 인해 다음 상태 코드가 발생합니다. 요청에 인증이 필요하지만 X-API-Session 헤더가 제공되지 않았거나 제공되었지만 세션 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 프로토콜 버전을 지정합니다.