知序ZHIXU AIR

接入指南

知序系统的对外接口统一经网关访问，生产环境的路径前缀为 /prod-api。不同对接角色使用不同的接口和鉴权方式，先在下表中找到你的场景。

场景方向鉴权方式文档
出票供应商主动拉单供应商 → 知序Header X-External-Token标准外采开放接口
平台调用供应商出票知序 → 供应商HMAC-SHA256 / Bearer Token / 无第三方自动出票供应商协议
推送航变消息外部系统 → 知序URL 参数 token航变消息接收接口
推送运价运价提供方 → 知序Header X-Direct-App-Id + X-Direct-App-Secret运价推送接口
OTA 搜索 / 验价 / 下单 / 支付OTA 平台 → 知序按平台协议，可加密报文OTA 平台接口

1. 申请对接凭证

联系知序商务或系统管理员，说明对接场景，获取：

  • 网关域名（测试 / 生产）；
  • 对应场景的凭证：供应商 Token、App Key / Secret、航变推送 token，或运价推送 AppId / AppSecret。
所有凭证只能通过安全渠道传递，不要写入公开仓库或前端代码。生产环境统一使用 HTTPS。

2. 发起第一次调用

以运价推送为例，先用同步接口推送一条报价：

curl -X POST 'https://你的网关域名/prod-api/direct/admin/crawler-quotes/import' \
  -H 'Content-Type: application/json' \
  -H 'X-Direct-App-Id: 你的AppId' \
  -H 'X-Direct-App-Secret: 你的AppSecret' \
  -d @quotes.json

以出票供应商拉单为例：

curl -X POST 'https://你的网关域名/prod-api/externalProcurement/openapi/v1/issue/orders/pull' \
  -H 'Content-Type: application/json' \
  -H 'X-External-Token: 你的供应商Token' \
  -d '{"limit": 20}'

3. 联调与验收

  • 每个接口都应覆盖成功、业务失败、重复请求（幂等）和超时重试场景；
  • 记录并回传请求 ID（X-Request-Id、traceId、procurementNo），便于双方定位问题；
  • 按各文档末尾的验收清单逐项确认后，再切换到生产环境。
上一篇
帮助中心