全国物流查询
快递单号查询物流轨迹，支持顺丰、三通一达等，不传公司代号则自动识别
调用地址：https://api.ynlskj.com.cn/gateway/express
请求方法：GET
在其他地方怎么调用
- 请求地址用上面的调用地址，参数拼在网址后面，例如
?number=%E5%BF%AB%E9%80%92%E5%8D%95%E5%8F%B7&type=&mobile= - 方法用
GET - API Key 只能放在请求头
X-API-Key，不要写进网址，也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制，登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
number | Query | 是 | 快递单号。也可用 nu。圆通/中通/韵达/申通等只传这个即可 |
type | Query | 否 | 快递公司代号，如 sf / yto / zto。不传则自动识别，一般不用填 |
mobile | Query | 仅顺丰/跨越 | 收/寄件人手机号后四位。其他快递不用传 |
X-API-Key | Header | 是 | 你的 API Key |
请求示例
| 场景 | Query 示例 |
|---|---|
| 自动识别公司 | {"number":"7730123456789"} |
| 指定中通 | {"number":"7730123456789","type":"zto"} |
| 查顺丰 | {"number":"SF1234567890","type":"sf","mobile":"1234"} |
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功，err 失败 |
code | 上游业务码，200 成功；400 参数错误；501 上游异常 |
errmsg | 上游原始提示，如「成功」 |
data.orderNo | 本次查询单号 |
data.info | 物流结果数组。单号无法识别或暂无轨迹时，可能只有 cpCode、mailNo |
data.info[].cpCode | 快递公司代号，如 STO / ZTO / SF |
data.info[].mailNo | 快递单号 |
data.info[].logisticsCompanyName | 快递公司名称 |
data.info[].logisticsStatus / logisticsStatusDesc | 状态码与中文，如 SIGN / 已签收 |
data.info[].theLastTime / theLastMessage | 最新轨迹时间与描述 |
data.info[].logisticsTraceDetailList | 轨迹数组：time（毫秒）、desc、logisticsStatus、areaName |
hint | 已识别公司但没有轨迹时的说明，例如未传手机号后四位、或快递尚未揽收 |
msg | 本站提示，如「次数充足，剩余 99 次」或「次数不足，剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key，不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/express?number=%E5%BF%AB%E9%80%92%E5%8D%95%E5%8F%B7&type=&mobile=');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥'],
]);
echo curl_exec($ch);
请求参数演示
{
"number": "快递单号",
"type": "sf",
"mobile": "手机号后四位"
}
响应演示
{
"ret": "ok",
"code": 200,
"success": true,
"errmsg": "成功",
"data": {
"orderNo": "296141744182247312",
"info": [
{
"cpCode": "ZTO",
"mailNo": "75876648253690",
"logisticsCompanyName": "中通快递",
"cpMobile": "95311",
"cpUrl": "https://www.zto.com/",
"logisticsStatus": "SIGN",
"logisticsStatusDesc": "已签收",
"theLastTime": "2022-05-09 22:45:05",
"theLastMessage": "您的快递已签收",
"takeTime": "2天21小时45分",
"logisticsTraceDetailList": [
{
"time": 1651840444000,
"logisticsStatus": "ACCEPT",
"areaName": "云南省,昆明市",
"desc": "【昆明经开】已揽收"
}
]
}
]
},
"msg": "次数充足，剩余 99 次",
"remain_quota": 99
}