다음 상태 코드가 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 | 게이트웨이 시간 초과 | 작업을 완료하기 전에 기한이 지났습니다. 시스템 상태를 변경하는 작업의 경우 작업이 성공적으로 완료되더라도 이 오류가 반환될 수 있습니다. 예를 들어 서버의 성공 응답이 오래 지연되어 기한이 지났을 수 있습니다. |
여러 오류 코드가 적용될 수 있는 경우도 있습니다. 서비스는 적용되는 가장 구체적인 오류 코드를 반환해야 합니다.