Vendor API 에러 코드 가이드 추가
Vendor API 개발 가이드에 에러 코드 페이지가 추가되었습니다.
공급사(Vendor)는 온다(ONDA Hub)로부터 API 요청을 받아 처리에 실패하는 경우, 이 페이지에 정의된 표준 에러 응답 포맷을 사용해야 합니다.
주요 내용
에러 응답 포맷
{
"code": "4000",
"error": "No rooms available for booking"
}
code와 error 두 필드 모두 필수이며, error 값은 정의된 영문 메시지를 그대로 사용해야 합니다.
에러 코드 목록
총 12개의 에러 코드가 카테고리별로 정의되어 있습니다.
| 카테고리 | 코드 범위 |
|---|---|
| SYSTEM_ERROR | 1000 |
| AUTH_ERROR | 2000 |
| VALIDATION_ERROR | 3000 |
| BUSINESS_ERROR | 4000 – 4007 |
| UNKNOWN_ERROR | 9999 |
특히 BUSINESS_ERROR 코드는 관련 엔드포인트(Create Reservation, Check Reservation, Cancel Reservation, Confirm Reservation)와 함께 안내되어 상황별로 어떤 코드를 반환해야 하는지 명확하게 파악할 수 있습니다.
자세한 내용은 에러 코드 가이드를 참고해 주세요.
문의
API 연동에 대해 궁금하신 사항이 있으시면 언제든지 문의해 주세요:
- 기술 문의: techsupport@onda.me