5 分钟快速开始

龙虾出行开放平台快速开始

用 5 个步骤跑通你的第一个出行交易：注册应用、获取 Key、搜索航班、创建订单、完成支付。

注册并创建应用

访问开发者后台，创建应用并获取 Sandbox API Key 与 Secret。

配置鉴权头

每个请求携带 X-App-Key、X-Timestamp、X-Nonce 与 HMAC-SHA256 签名。

搜索航班

调用 /open/v1/flight/search，拿到航班列表与 search_offer_id。

验价并下单

用 search_offer_id 调用 pricing 获取 offer_id，再调用 create_flight_order 创建订单。

支付并查询

使用 create_payment 或收银台链接完成支付，用 query_payment_status 轮询状态。

import { RideClaw } from "@rideclaw/sdk";

const rideclaw = new RideClaw({
  apiKey: process.env.RIDECLAW_API_KEY,
  baseURL: "https://api.longxiachuxing.com/open/v1",
});

async function main() {
  // 1. 搜索航班
  const search = await rideclaw.flight.search({
    trip_mode: "domestic",
    trip_type: "oneway",
    from_code: "SZX",
    to_code: "SHA",
    depart_date: "2026-06-20",
    passengers: { adult: 1 },
  });
  console.log(search.flights[0]);

  // 2. 验价
  const pricing = await rideclaw.flight.pricing({
    search_offer_id: search.flights[0].cabins[0].search_offer_id,
    passengers: [{ type: "adult", name: "张三", id_type: "ID_CARD", id_number: "...", phone: "..." }],
  });

  // 3. 创建订单
  const order = await rideclaw.flight.createOrder({
    offer_id: pricing.offer_id,
    idempotency_key: "demo_001",
    contact: { name: "张三", phone: "13800138000" },
    passengers: [{ type: "adult", name: "张三", id_type: "ID_CARD", id_number: "...", phone: "..." }],
  });
  console.log(order.system_no, order.checkout_url);
}

下一步

阅读认证文档，理解 HMAC 签名与 Bearer Token 两种鉴权方式。
查看 MCP Server 文档，把搜索/下单能力暴露给 AI Agent。
在开发者后台查看 API 调用日志与错误概览。