1)请求地址
https://v.1dq.com/api/a95
2)示范URL
https://v.1dq.com/api/a95?key=您的key&com=EMS&no=12345678
3)请求参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
key |
string |
Y |
AppKey在我的数据页面 |
xxxxxx |
- |
com |
string |
Y |
快递公司简称, auto 为自动识别,如果无法识别,请填写快递公司简称 |
EMS |
- |
no |
string |
Y |
快递单号 |
12345678 |
- |
4)选填参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
trans_id |
string |
N |
用户订单号,24 字符以内 |
2017201230 |
- |
trans_date |
string |
N |
用户订单时间,格式为YYmmddHHiiss |
20160112122233 |
- |
trans_remark |
string |
N |
用户备注,原路返回 |
xxx |
- |
account |
string |
N |
是否返回账户信息 ,如需返回剩余可用次数,请传递auto如果账户是按次数扣除,则返回剩余次数如账户是按金额扣除,则返回账户剩余金额
|
auto |
- |
output |
string |
N |
输出格式,默认JSON;可选项JSON/XML |
JSON |
- |
5)返回参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
error_code |
int |
Y |
状态码 |
- |
- |
reason |
string |
Y |
状态说明 |
- |
- |
ordersign |
string |
Y |
订单号 |
- |
- |
result |
string |
Y |
结果集 |
- |
- |
6)返回JSON结果示例
{
"error_code": 0,
"reason": "success",
"result": {
"state": 1, /* 0 无记录 1 在途中 2 派送中 3 已签收 4 问题件 */
"uptime": "2017-10-15 16:17:24", /*最后更新时间*/
"data": [
{
"time": "2017-10-14 03:52:10", /*时间*/
"remark": "您的包裹正在发往 已进行装袋扫描 的运输途中" /*状态*/
},
{
"time": "2017-10-14 03:52:10",
"remark": "上海航空部-已发往-北京航空部"
},
{
"time": "2017-10-14 02:18:45",
"remark": "已到达-上海航空部"
}
],
"information": {
"no": "402795269678", /*快递单号*/
"sName": "STO", /*快递公司简称*/
"expName": "申通快递", /*快递名称*/
"url": "http://www.sto.cn", /*网址*/
"tel": "400-889-5543", /*快递电话*/
"img": "https://oss-cn2.apistore.cn/exp/STO.png" /*logo*/
}
},
"ordersign": "20171015161723565551491009"
}