모든 응답에는 HTTP 상태 코드가 포함되며, 상태 코드가 204(No Content)인 경우, 수락 헤더가 포함되지 않습니다. 응답 컨텐츠는 요청에 따라 다릅니다. 일부 응답에는 문서 본문이 포함되고 일부는 URL만 포함하고 일부는 비어 있습니다.

HTTP 응답 코드

API 클라이언트는 응답에서 HTTP 상태 코드의 하위 집합을 예상할 수 있습니다.

표 1. API가 반환하는 HTTP 상태 코드
상태 코드 상태 설명
200 OK 요청이 유효하며 완료되었습니다. 응답에 문서 본문이 포함되어 있습니다.
201 Created 요청이 유효합니다. 요청된 개체가 생성되었으며 위치 헤더에 지정된 URL에서 찾을 수 있습니다.
202 Accepted 요청이 유효하고 이를 처리하기 위해 작업이 생성되었습니다. 이 응답은 일반적으로 TaskStatus 요소와 함께 제공됩니다.
204 No Content 요청이 유효하며 완료되었습니다. 응답에 본문이 포함되지 않습니다.
400 Bad Request 요청 본문이 잘못된 형식이거나 불완전하거나 유효하지 않습니다.
401 Unauthorized 로그인 실패 또는 인증 토큰이 만료되었습니다.
403 Forbidden 사용자가 인증되지 않았거나 요청에 지정된 하나 이상의 개체에 액세스하기 위한 적절한 권한이 없습니다.
404 Not Found 요청에 지정된 개체를 찾을 수 없습니다.
405 Method Not Allowed 요청에 지정된 HTTP 메서드가 이 개체에 대해 지원되지 않습니다.
406 Not Acceptable 요청으로 식별된 리소스가 요청의 Accept 헤더에 지정된 유형에 대한 응답을 생성할 수 없습니다.
415 Unsupported Media Type 요청으로 식별된 리소스가 지정된 Content-Type 및 HTTP 메서드의 요청을 지원하지 않습니다.
422 Not Found 일반적으로 잘못된 형식의 요청 URL 또는 요청 본문을 나타냅니다.
429 Too Many Requests 클라이언트가 너무 많은 요청을 전송했거나 여러 클라이언트가 동시에 요청을 너무 많이 전송하고 있으므로 서버가 속도 제한으로 인해 이를 처리할 수 없습니다.

이 문제를 해결하려면 나중에 요청을 다시 전송합니다.

500 Internal Server Error 요청을 받았지만 서버에서 내부 오류가 발생하여 완료할 수 없습니다.
503 Service Unavailable 서버가 리소스 소모 또는 서버 유지 보수와 같은 일시적인 상태로 인해 현재 요청을 처리할 수 없습니다.
504 Gateway Timeout 서버가 게이트웨이 또는 프록시로 작동하는 동안 요청 URL에서 지정된 업스트림 서버에서 적시에 응답을 받지 못했습니다.