跳到主要内容
在线演示

快速入门

五个步骤，从注册到在沙箱中完成一张机票预订。

  1. 1. 获取沙箱凭据
  2. 2. 为每个请求签名
  3. 3. 发起第一次调用
  4. 4. 走通预订流程
  5. 5. 申请生产环境

1. 获取沙箱凭据

在旅游 API 页面注册。邮箱验证通过后，您的合作伙伴账户即创建完成，屏幕上会显示沙箱密钥 ID；Secret 通过发送到同一邮箱的一次性查看链接交付。请将其保存到您的密钥管理工具中——它只会显示一次。

您还会收到开发者门户的临时密码，可在门户中创建和轮换密钥、设置 IP 白名单、查看用量并申请生产环境。

2. 为每个请求签名

每次调用都携带四个请求头：X-API-Key（您的密钥 ID）、X-Timestamp（Unix 秒）、X-Nonce（16–128 个随机字符）以及 X-Signature——即以您的 Secret 为密钥，对规范字符串计算的 HMAC-SHA256，采用小写十六进制表示。

规范字符串由五行组成，以换行符连接：大写的 HTTP 方法、与发送时完全一致的路径加查询字符串、时间戳、nonce，以及原始请求体的小写十六进制 SHA-256（空请求体取零字节的 SHA-256）。时间戳与我们的时钟相差不得超过 300 秒；同一 nonce 在 10 分钟内只能使用一次。

规范字符串
POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. 发起第一次调用

在沙箱中搜索航班。沙箱连接的是我们供应商的测试环境，因此搜索返回的是测试库存和价格，在沙箱中下的预订也是测试预订——不会出真实机票，也不会扣费。每个参考页面都提供 cURL、Node.js、Python 和 PHP 的完整示例——复制下来，填入您的密钥 ID 和 Secret，即可运行。

cURL
curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. 走通预订流程

机票：搜索 → 为所选报价定价 → 使用乘客和联系人信息创建订单 → 出票 → （可选）获取退款报价并申请退款。酒店：搜索 → 读取某家酒店的房型 → 核验价格 → 创建预订 → （可选）获取取消报价并取消。

报价 ID 和价格密钥（rate key）都是不透明的，且有效期很短。提交前请务必先定价或核验：如果价格有变，您会收到带有新金额的 409 price_changed，由您决定是否继续。

5. 申请生产环境

当您的集成在沙箱中端到端走通整个流程后，打开开发者门户申请生产环境。我们会审核沙箱活动（搜索、一笔订单、一笔预订、一次取消）和您的集成详情，然后切换您的账户：生产环境密钥对将通过同样的一次性查看链接以邮件发送。基础 URL 不变——使用 dt_live_ 密钥签名的请求会到达真实供应商，并从您的保证金中结算；您的沙箱密钥仍可继续用于测试。