Error handling

HTTP Status Code vs Business Error Code

Our API uses a dual-layer error system:

HTTP Status Code - Standard HTTP response status (200, 400, 401, etc.)

Business Error Code - Custom business logic error codes in response body

Important: Always check the code field in the response body, not just the HTTP status code.

HTTP Status	Meaning	Description
200	Success	Request processed successfully
400	Bad Request	Request parameter validation failed
401	Unauthorized	Invalid or expired token
403	Forbidden	No access to resource
404	Not Found	Requested resource not found
429	Too Many Requests	Exceeded request frequency limit
500	Internal Server Error	Internal server error
504	Gateway Timeout	Request processing timeout

Business error codes follow the format: [x][xx][xx][xxxx]

Error Code	HTTP Status	Meaning	Description
0	200	Success	Request successful
100000400	400	Parameter Error	Request parameter validation failed
100000401	401	Authentication Failed	Invalid or expired token
100000403	403	Permission Denied	No access to resource
100000404	404	Not Found	Requested resource not found
100000429	429	Rate Limited	Exceeded request frequency limit
100000500	500	System Error	Internal server error
100000504	504	Timeout	Request processing timeout
100001003	500	Duplicate Error	Duplicate resource or operation
100001004	500	Dependency Error	External dependency failure
100001005	400	Page Size Exceeded	Page size exceeds maximum limit
100001006	400	Not Implemented	Feature not implemented
100001007	400	Expired	Resource or token expired
100001008	400	Not Matched	Data does not match expected format
100001111	200	ARI Changed	Availability/rate information changed
100001112	200	Credit Limit	Booking failed due to credit limit exceeded

All error responses follow this structure:

{
    "code": 100000400,
    "msg": "param error"
}

Successful responses include data:

{
    "code": 0,
    "msg": "Success",
    "data": {
        // Your response data here
    }
}

Always check body.code - HTTP status codes are for transport-level errors

Business logic errors use HTTP 200 with non-zero code values

Transport errors use appropriate HTTP status codes (4xx, 5xx)

Retry logic should be based on business error codes, not HTTP status codes