HTTP 상태 코드

다음 상태 코드가 HTTP 응답에서 반환될 수 있습니다.

HTTP 코드 HTTP 설명 참고
2xx 정상 오류 아님, 성공 시 반환 비즈니스 로직 실패에도 사용해야 합니다(예: CreateBookingResponse의 booking_failure가 채워짐).
400 잘못된 요청 잘못된 요청 또는 잘못된 인수입니다 (판매자, 서비스, 시간대를 찾을 수 없음, 잘못된 시간대에 예약 시도, 존재하지 않는 예약 취소).
401 승인되지 않음 인증이 완료되지 않았습니다(잘못된 사용자 인증 정보, 로그인 다시 시도). 요청에 작업과 관련된 올바른 사용자 인증 정보가 없습니다.
403 금지됨 권한이 거부 또는 금지되었습니다(호출자가 알려져 있고 거부됨). 일부 리소스가 소진되어 거부된 경우에는 이 응답을 사용해서는 안 됩니다. 대신 이러한 오류에는 Too Many Requests 코드를 사용히세요. 호출자를 식별할 수 없는 경우에는 Forbidden가 아닌 Unauthorized를 사용해야 합니다.
404 찾을 수 없음 요청한 항목을 찾을 수 없습니다(잘못된 RPC 포함, 잘못된 URL, 리소스를 찾을 수 없음).
409 충돌 작업이 취소되었습니다. 대개 시퀀서 확인 실패, 트랜잭션 취소 등의 동시 실행 문제가 원인입니다.
429 요청한 횟수가 너무 많음 일부 리소스가 소진되었습니다. 사용자당 할당량이나 전체 파일 시스템의 저장용량이 부족하기 때문일 수 있습니다.
499 고객이 요청을 종료함 작업이 취소되었습니다. 대개 호출자에 의해 취소됩니다.
500 내부 서버 오류 내부 오류가 발생했습니다. 이는 기본 시스템에서 예상하는 불변 항목에 문제가 있는 경우입니다. 이 오류 코드는 심각한 오류를 위해 예약되어 있습니다.
501 구현되지 않음 작업이 구현되지 않았거나 이 서비스에서 지원되지 않거나 사용 설정되지 않았습니다.
503 서비스를 사용할 수 없음 현재 서비스를 사용할 수 없습니다. 일시적인 상태일 가능성이 높으며, 잠시 시간을 두고 다시 시도하면 해결될 수 있습니다.
504 게이트웨이 시간 초과 작업을 완료하기 전에 기한이 지났습니다. 시스템의 상태를 변경하는 작업의 경우 작업이 정상적으로 완료되어도 이 오류가 반환될 수 있습니다. 예를 들어 서버의 성공 응답이 오래 지연되어 기한이 지났을 수 있습니다.

여러 오류 코드가 적용될 수 있는 경우도 있습니다. 서비스는 적용되는 오류 코드 중 가장 구체적인 코드를 반환해야 합니다.