错误码字典

开放接口以「稳定机器码 + HTTP 状态 + 中文说明」三件套返回错误，第三方据此写分支逻辑。每个错误码均有独立页面，可直接从接口响应里的 documentUrl 跳转。

HTTP 400

机器码	说明	详情
`invalid_parameter`	参数格式或取值非法	详情 →
`missing_parameter`	缺少必填参数	详情 →
`invalid_json`	请求体不是合法 JSON	详情 →
`invalid_amount`	金额非法，必须为整数分	详情 →
`date_range_invalid`	日期区间非法	详情 →
`invalid_signature_version`	签名版本不支持	详情 →

HTTP 401

机器码	说明	详情
`unauthorized`	未提供任何凭证	详情 →
`invalid_app_id`	AppId 不存在或与当前环境不匹配	详情 →
`signature_mismatch`	签名不匹配	详情 →
`timestamp_expired`	请求时间与服务器相差超过 300 秒	详情 →
`nonce_replayed`	Nonce 已被使用，请每次请求重新生成	详情 →
`invalid_token`	access_token 无效	详情 →
`token_expired`	access_token 已过期，请用 refresh_token 刷新	详情 →

HTTP 403

机器码	说明	详情
`forbidden`	禁止访问	详情 →
`app_disabled`	应用已被停用，请联系平台运营	详情 →
`tenant_mismatch`	资源不属于该应用绑定的租户	详情 →
`not_owner`	资源不属于当前凭证主体	详情 →
`insufficient_scope`	应用未获得该 scope，请在控制台申请	详情 →
`ip_not_allowed`	出口 IP 不在白名单内	详情 →

HTTP 404

机器码	说明	详情
`resource_not_found`	资源不存在	详情 →
`hotel_not_found`	酒店不存在或未对渠道开放	详情 →
`room_type_not_found`	房型不存在	详情 →
`order_not_found`	订单不存在	详情 →
`rate_plan_not_found`	房价计划不存在或不可订	详情 →
`endpoint_not_found`	接口不存在，请检查版本号与路径	详情 →

HTTP 409

机器码	说明	详情
`conflict`	资源状态冲突	详情 →
`inventory_insufficient`	库存不足或已售完	详情 →
`order_status_conflict`	订单当前状态不允许该操作	详情 →
`idempotency_conflict`	幂等键已用于内容不同的请求	详情 →
`duplicate_review`	该订单已评价	详情 →

HTTP 422

机器码	说明	详情
`business_rule_violation`	违反业务规则	详情 →
`exceed_max_rooms`	超过单笔最大房间数	详情 →
`coupon_not_eligible`	券不可用（未达门槛／已过期／门店不符）	详情 →
`points_insufficient`	积分不足	详情 →
`member_not_enrolled`	该手机号不是会员	详情 →

HTTP 429

机器码	说明	详情
`rate_limit_exceeded`	请求频率超出配额，请稍后重试	详情 →
`quota_exceeded`	超过调用配额	详情 →

HTTP 500

机器码	说明	详情
`internal_error`	平台内部错误	详情 →

HTTP 502

机器码	说明	详情
`upstream_unavailable`	依赖服务不可用，请稍后重试	详情 →

HTTP 503

机器码	说明	详情
`maintenance`	系统维护中	详情 →