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. 快速开始

接入流程

本文档面向接入龙虾出行开放平台的合作方,说明 /open/v1/* 业务接口的接入方式、Bearer Token 鉴权规则、接口定义、错误码及调用注意事项。
当前已开放的能力包括:
机票:航班搜索、机场搜索、验价、下单
酒店:酒店搜索、房型/产品查询、下单

一、接入流程#

1.
访问官网 https://open.longxiachuxing.com/ 注册开发者账号并完成激活,平台会自动为应用签发 Bearer Token:
rdak_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
2.
在控制台一并配置调用方公网出口 IP(白名单),白名单为空时拒绝所有请求。
3.
按本文档实现 Bearer 鉴权,可直接使用 rdak_live_* 进入生产调用。
4.
默认配额满足不了业务量时,再联系开放平台运营提升 qps_limit / daily_limit 或调整 IP 白名单等高级配置。

二、基础信息#

2.1 接口域名#

环境域名
生产环境https://open.longxiachuxing.com/api
所有接口路径均以 basePath = /api 为前缀,例如机票搜索的完整 URL 为:
https://open.longxiachuxing.com/api/open/v1/flight/search

2.2 接口路径概览#

接口方法路径
机票搜索POST/open/v1/flight/search
机场搜索GET/open/v1/flight/airport/search
机票验价POST/open/v1/flight/pricing
创建机票订单POST/open/v1/flight/order/create
酒店搜索POST/open/v1/hotel/search
酒店房型详情POST/open/v1/hotel/rooms
创建酒店订单POST/open/v1/hotel/order/create

2.3 响应约定#

所有业务响应的 HTTP 状态码均为 200(鉴权失败、限流等少量场景会返回 401 / 403 / 429 / 503)。
业务成功与失败通过响应体中的 code 字段区分,0 为成功。
每次请求都会返回 request_id,排查问题时请提供该值。
标准响应结构:
{
  "code": 0,
  "message": "ok",
  "data": {},
  "request_id": "f3c2a1b4d5e6f7890123456789abcdef"
}
金额单位统一为 元(float64,CNY)。
修改于 2026-06-10 04:12:57
上一页
欢迎语
下一页
公共请求头
Built with