API 错误响应

HTTP状态代码和讯息

当一个请求由于请求中的错误而失败时,错误响应讯息将以JSON格式被返回。

错误响应讯息包括端点的唯一错误代码,HTTP响应讯息和HTTP响应代码。当被启用时,响应将包含HATOAS链接。

响应例子
{
    "error": {
        "code": "not_found",
        "message": "产品找不到或已过期,提供UUID: :uuid: d3bfa3e1-e",
        "http_code": 404
    },
    "links": [
        {
            "method": "GET",
            "rel": "docs",
            "href": "https://bmglabsapi.docs.apiary.io/#reference/products/product"
        }
    ],
    "timestamp": "2018-08-02T16:43:33.184+08:00"
}


响应代码和示例讯息列表。
General
http status
API error Code
Message (example)
400 error
400 invalid_params 城市未找到: :uuid: ...'
401 GEN-UNAUTHORIZED Unauthorized
404 not_found 产品找不到或已过期,提供UUID: ...
410 gone 产品不存在
500 internal_error 对不起,系统报错,我们会尽快处理。
/bookings
400 malformed_json JSON处理结果: ...
400 invalid_params 被禁止的参数: ...
403 insufficient_balance 钱包余额不足, 无法下单。目前余额: ...
404 upload_failed Uploded file is too big
404 upload_failed No upload content
409 invalid_action 订单没有“供确认”状态。你无法确认此订单: ...
409 invalid_action Booking has status waiting. You cannot request cancellation until aproved.
409 invalid_action 订单已经取消。此订单不可以被再次取消: ...
422 invalid_data 抵达日期不能是过去
422 no_product 产品类型Uuid缺失: ...
422 no_product 元素的数量在\'perPax\'阵列必须是同等数量的客人。
422 no_product 此产品API中无法提供预订
422 prices_mismatch 旅行日期已经不可用。请选择其他日期。