轻易云
注册体验
POSThttps://qimen.api.taobao.com/router/qmapp_key + app_secret MD5 签名(奇门网关)

奇门网关公共参数与签名(target_app_key 路由)

奇门(菜鸟仓储/ERP 对接网关)调用规范:统一网关 router/qm,公共参数 method、app_key、timestamp、v、sign_method、sign;聚水潭奇门自定义接口需带 target_app_key=23060081 与 customer_id 路由到商家。

来源：https://open.taobao.com/doc.htm?docId=106850&docType=1
## 接口说明 奇门是阿里官方制定的 ERP 与 WMS/物流之间的标准对接网关。所有请求 POST 到统一网关地址,以 method 区分业务接口,用 app_key + app_secret 做 MD5 签名鉴权。聚水潭的大部分深度数据(淘系订单、出库明细、分仓库存)只能通过【奇门自定义接口】获取:请求中 target_app_key 固定为 23060081(聚水潭),并额外携带 customer_id 路由到具体商家链接。 ### 公共参数 | 参数 | 说明 | | --- | --- | | method | 接口名,如 taobao.qimen.stock.query、jushuitan.saleout.list.query | | app_key | 淘宝开放平台应用 AppKey | | target_app_key | 目标系统 AppKey,聚水潭固定 23060081 | | customer_id | 聚水潭商家路由参数(授权时向聚水潭获取) | | timestamp | yyyy-MM-dd HH:mm:ss 格式时间戳 | | v / format / sign_method | 版本(2.0)、响应格式、签名方式(md5) | | sign | 签名 | ### 签名算法 1. 除 sign 外所有参数按参数名 ASCII 升序排序; 2. 按 key + value 顺序直接拼接(无分隔符); 3. 首尾拼接 app_secret; 4. MD5 并转大写,得到 sign。 ### 注意事项 - 奇门自定义接口有独立限频(聚水潭侧常见 QPS 10),同步任务要内置限速与退避重试。 - customer_id 与商家绑定关系在授权环节确定,多商家 ISV 需按商家维度维护路由表。

代码示例

pseudo
sysParams = { method, app_key, target_app_key: "23060081", customer_id,
              timestamp, v: "2.0", format: "json", sign_method: "md5" }
sign = upper(md5(app_secret + concatSortedKV(sysParams + bizParams) + app_secret))
POST https://qimen.api.taobao.com/router/qm  (form-urlencoded)

错误码

错误码消息含义
INVALID_SIGNATURE签名非法检查参数排序、拼接与 app_secret,sign 需大写
LIMITED触发限频超过 QPS 限制,降速并退避重试
CUSTOMER_NOT_FOUNDcustomer_id 无效商家路由参数错误或未授权