快递查询
接口地址
https://binstd.apistd.com/express/query
响应格式
application/json
请求方法
POST
请求参数 (Query)
参数名 | 类型 | 必须 | 描述 |
---|---|---|---|
key string | string | 是 | 请求 AccessKey, 请在控制台中查看 |
type string | string | 是 | 快递公司 自动识别请写auto |
number string | string | 是 | 快递单号 |
mobile string | string | 否 | 收件人/寄件人手机号(顺丰快递需要) |
返回参数 (Body)
参数名 | 类型 | 描述 |
---|---|---|
status string | string | 返回码 |
msg string | string | 返回说明信息 |
result object | object | 返回结果 |
└ time string | string | 时间 |
└ status string | string | 状态 |
└ issign string | string | 是否签收(已弃用,请使用deliverystatus) |
└ type string | string | 快递公司 |
└ number string | string | 快递单号 |
└ deliverystatus int | int | 物流状态 1在途中 2派件中 3已签收 4派送失败(拒签等) |
请求返回示例
{
"status": "0",
"msg": "ok",
"result": {
"list": [
{
"time": "2015-10-20 10:24:04",
"status": "顺丰速运 已收取快件"
},
{
"time": "2015-10-20 11:49:26",
"status": "快件离开【广州龙怡服务点】,正发往 【广州番禺集散中心】"
},
{
"time": "2015-10-21 09:22:10",
"status": "已签收,感谢使用顺丰,期待再次为您服务"
},
{
"time": "2015-10-21 09:22:10",
"status": "在官网\"运单资料&签收图\",可查看签收人信息"
}
],
"issign": "1"
}
}
快递公司
接口地址
https://binstd.apistd.com/express/type
响应格式
application/json
请求方法
GET
请求参数 (Query)
参数名 | 类型 | 必须 | 描述 |
---|---|---|---|
key string | string | 是 | 请求 AccessKey, 请在控制台中查看 |
返回参数 (Body)
参数名 | 类型 | 描述 |
---|---|---|
status string | string | 返回码 |
msg string | string | 返回说明信息 |
result array | array | 返回结果 |
└ name string | string | 快递名称 |
└ type string | string | 快递代号 |
└ letter string | string | 首字母 |
└ tel string | string | 电话 |
└ number string | string | 测试单号 |
请求返回示例
{
"status": "0",
"msg": "ok",
"result": [
{
"name": "德邦",
"type": "DEPPON",
"letter": "D",
"tel": "95353",
"number": "330060412"
},
{
"name": "D速",
"type": "DEXP",
"letter": "D",
"tel": "0531-88636363",
"number": "316J103367777"
},
{
"name": "DHL",
"type": "DHL",
"letter": "D",
"tel": "800-810-8000 400-810-8000",
"number": "5846399171"
},
{
"name": "EMS",
"type": "EMS",
"letter": "E",
"tel": "40080-11183",
"number": "1082490090717"
},
{
"name": "FedEx",
"type": "FEDEX",
"letter": "F",
"tel": "800-988-1888 400-886-1888",
"number": "120949498648"
},
{
"name": "国通",
"type": "GTO",
"letter": "G",
"tel": "4001-111-123",
"number": "2639589835"
},
{
"name": "能达",
"type": "ND56",
"letter": "G",
"tel": "400-6886-765",
"number": ""
},
{
"name": "汇通",
"type": "HTKY",
"letter": "H",
"tel": "4009565656",
"number": "210937745480"
},
{
"name": "京东",
"type": "JD",
"letter": "J",
"tel": "",
"number": "12290972964"
},
{
"name": "嘉里物流",
"type": "KERRY",
"letter": "J",
"tel": "852-2410-3600",
"number": "316B455817673"
},
{
"name": "佳吉",
"type": "JIAJI",
"letter": "J",
"tel": "400-820-5566",
"number": "729976312"
},
{
"name": "京广",
"type": "KKE",
"letter": "J",
"tel": "852-23329918",
"number": "7102293245"
},
{
"name": "佳怡",
"type": "JIAYI",
"letter": "J",
"tel": "400-631-9999",
"number": ""
},
{
"name": "加运美",
"type": "TMS",
"letter": "J",
"tel": "0769-85515555 ",
"number": "2197050107"
},
{
"name": "急先达",
"type": "JOUST",
"letter": "J",
"tel": "400-694-1256",
"number": ""
},
{
"name": "跨越",
"type": "KYEXPRESS",
"letter": "K",
"tel": "4008-098-098",
"number": "2628904"
},
{
"name": "快捷",
"type": "FASTEXPRESS",
"letter": "K",
"tel": "4008-333-666",
"number": "536135784093"
},
{
"name": "龙邦",
"type": "LBEX",
"letter": "L",
"tel": "021-59218889",
"number": "686013186447"
},
{
"name": "全峰",
"type": "QFKD",
"letter": "Q",
"tel": "4001-000-001",
"number": "720166045326"
},
{
"name": "全晨",
"type": "QCKD",
"letter": "Q",
"tel": "0769-82026703",
"number": "2233244233"
},
{
"name": "全一",
"type": "APEX",
"letter": "Q",
"tel": "400-663-1111",
"number": "112276086230"
},
{
"name": "如风达",
"type": "RFD",
"letter": "R",
"tel": "400-010-6660",
"number": "11604247156509"
},
{
"name": "顺丰",
"type": "SFEXPRESS",
"letter": "S",
"tel": "95338",
"number": "664934099535"
},
{
"name": "申通",
"type": "STO",
"letter": "S",
"tel": "95543",
"number": "3310265451646"
},
{
"name": "三态",
"type": "SFC",
"letter": "S",
"tel": "400-881-8106",
"number": ""
},
{
"name": "盛辉",
"type": "SHENGHUI",
"letter": "S",
"tel": "400-822-2222",
"number": "240815442"
},
{
"name": "速尔",
"type": "SURE",
"letter": "S",
"tel": "400-158-9888",
"number": "880218258595"
},
{
"name": "天天",
"type": "TTKDEX",
"letter": "T",
"tel": "4001-888-888",
"number": "560516990584"
},
{
"name": "天地华宇",
"type": "HOAU",
"letter": "T",
"tel": "400-808-6666",
"number": "020286402"
},
{
"name": "TNT",
"type": "TNT",
"letter": "T",
"tel": "800-820-9868",
"number": "335939905"
},
{
"name": "UPS",
"type": "UPS",
"letter": "U",
"tel": "800-820-8388 400-820-8388",
"number": "1ZV6509Y0468336755"
},
{
"name": "万象",
"type": "EWINSHINE",
"letter": "W",
"tel": "400-820-8088",
"number": "2225195562855"
},
{
"name": "万家物流",
"type": "WANJIA",
"letter": "W",
"tel": "4001-156-561",
"number": "31000001425628"
},
{
"name": "新邦",
"type": "XBWL",
"letter": "X",
"tel": "4008-000-222",
"number": "23624522"
},
{
"name": "圆通",
"type": "YTO",
"letter": "Y",
"tel": "021-69777888 021-69777999",
"number": "100587985104"
},
{
"name": "韵达",
"type": "YUNDA",
"letter": "Y",
"tel": "95546",
"number": "1202237859178"
},
{
"name": "邮政包裹",
"type": "CHINAPOST",
"letter": "Y",
"tel": "11185",
"number": "9610027635439"
},
{
"name": "源安达",
"type": "YADEX",
"letter": "Y",
"tel": "0769-85021875",
"number": ""
},
{
"name": "运通",
"type": "YTEXPRESS",
"letter": "Y",
"tel": "0769-81156999",
"number": "666316719"
},
{
"name": "越丰",
"type": "YFEXPRESS",
"letter": "Y",
"tel": "(852) 2390 9969 ",
"number": ""
},
{
"name": "优速",
"type": "UC56",
"letter": "Y",
"tel": "400-1111-119",
"number": "518166035710"
},
{
"name": "中通",
"type": "ZTO",
"letter": "Z",
"tel": "95311",
"number": "728694125248"
},
{
"name": "宅急送",
"type": "ZJS",
"letter": "Z",
"tel": "400-6789-000",
"number": "6521513331"
},
{
"name": "中铁",
"type": "CRE",
"letter": "Z",
"tel": "95572",
"number": "0698042"
}
]
}
错误码 | 描述 |
---|---|
0 | 成功 |
201 | 快递单号为空 |
202 | 快递公司为空 |
203 | 快递公司不存在 |
204 | 快递公司识别失败 |
205 | 没有信息 |
206 | 快递单号错误 |
207 | 快递单号错误次数过多 |
const https = require('https');
const options = {
'method': 'POST',
'hostname': 'binstd.apistd.com',
'path': '/express/query?key=your_access_key_here&type=auto&number=773058962040428'
};
const req = https.request(options, (res) => {
const chunks = [];
res.on("data", (chunk) => {
chunks.push(chunk);
});
res.on("end", (chunk) => {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
res.on("error", (error) => {
console.error(error);
});
});
req.end();
* 以上示例代码仅供参考,建议根据您的实际业务场景及技术架构发起 HTTP API 请求