1. 快速开始
龙虾开放平台(通用版)
  • 欢迎语
  • 快速开始
    • 接入流程
    • 公共请求头
    • 注意事项
    • 速率限制与配额策略
    • 鉴权说明
    • 错误码
  • 机票
    • 机票接口说明
    • 机场搜索
      GET
    • 创建机票订单
      POST
    • 机票验价
      POST
    • 机票查询列表
      POST
  • 酒店
    • 酒店接口说明
    • 酒店查询列表
      POST
    • 酒店房型详情
      POST
    • 创建酒店订单
      POST
  • 数据模型
    • response.Response
    • schema.AirportSearchResponse
    • schema.FlightOrderCreateRequest
    • schema.FlightOrderCreateResponse
    • schema.FlightPricingRequest
    • schema.FlightPricingResponse
    • schema.FlightSearchResponse
    • schema.HotelOrderCreateRequest
    • schema.HotelOrderCreateResponse
    • schema.HotelRoomsRequest
    • schema.HotelRoomsResponse
    • schema.HotelSearchRequest
    • schema.HotelSearchResponse
    • schema.AirportItem
    • schema.ContactInfo
    • schema.InvoiceAddress
    • schema.PassengerInfo
    • schema.PassengerFareItem
    • schema.FlightItem
    • schema.GuestInfo
    • schema.RoomType
    • schema.HotelSearchFilters
    • schema.HotelItem
    • schema.PageInfo
    • schema.CabinFareItem
    • schema.RoomTypeProduct
  1. 快速开始

错误码

所有业务错误均通过响应体中的 code 字段表达,失败时 data 为 null,request_id 始终返回。
错误码段约定:
0:成功
400xx:参数 / Body 相关错误
401xx:鉴权失败(未带 / 错误的 Token、签名等)
403xx:权限不足(应用禁用、IP 不在白名单、环境不一致等)
429xx:限流
500xx / 503xx:服务端错误或下游不可用
codeHTTP含义
0200成功
40001400读取请求体失败
40005413请求体过大
40101401缺少 X-App-Key(仅签名链路)
40102401缺少签名头 X-Timestamp/X-Nonce/X-Sign(仅签名链路)
40103401X-Timestamp 非法(仅签名链路)
40104401时间戳偏移超限(仅签名链路)
40105401app_key 无效(仅签名链路)
40106401签名验证失败(仅签名链路)
40107401Nonce 重放(仅签名链路)
40110401服务端未启用 Bearer Token 鉴权
40111401Bearer 令牌格式非法
40112401Bearer 令牌无效
40113401Bearer 令牌已吊销
40114401Bearer 令牌已过期
40301403应用已禁用
40302403令牌环境与当前平台不一致
40303403来源 IP 不在白名单
40304403该应用未启用 Bearer Token 鉴权
40305403该应用未启用签名鉴权,请使用 Bearer Token
40201200请求参数不合法
40202200请求参数缺失
42901429触发 QPS 上限
42902429触发日调用量上限
50001500服务内部错误
50301503防重放服务暂不可用,请稍后重试
50401200上游数据源超时
错误响应示例:
{
  "code": 40112,
  "message": "Bearer 令牌无效",
  "data": null,
  "request_id": "a1b2c3d4e5f6..."
}
业务接口本身的参数校验失败一般使用 40201 / 40202,HTTP 状态仍为 200,请通过 code 字段判断。
修改于 2026-06-10 04:04:16
上一页
鉴权说明
下一页
机票接口说明
Built with