关于javascript:快递100地图轨迹查询API接口案例

一、快递查问地图轨迹

1.1 接口格局

提供对立格局的HTTP POST或GET调用接口,并返回格局反对JSON，xml，text，html数据。

1.2 申请地址

https://poll.kuaidi100.com/po...

申请参数：

参数名	是否必填	类型	阐明
customer	是	string	受权码，请申请企业版获取
sign	是	string	签名，用于验证身份，按param + key + customer 的程序进行MD5加密（留神加密后字符串肯定要转32位大写），不须要加上“+”号
param	是	param	由其余字段拼接

param数据结构：

参数名	是否必填	类型	阐明
com	是	string	查问的快递公司的编码，一律用小写字母
num	是	string	查问的快递单号，单号的最大长度是32个字符
phone	否	string	收、寄件人的电话号码（手机和固定电话均可，只能填写一个，顺丰单号必填，其余快递公司选填。如座机号码有分机号，分机号无需上传。）
from	是	string	出发地信息，如：广东省深圳市南山区金蝶软件园
to	是	string	目的地信息，如：北京朝阳区国际金融大厦
show	否	string	返回格局：0：json格局（默认），1：xml，2：html，3：text
order	否	string	返回后果排序:desc降序（默认）,asc 升序
orderTime	否	string	订单下单工夫，格局为（yyyy-MM-dd HH:mm:ss）如：2020-12-16 12:59:59

1.3 申请实例

customer=**  sign=**  param={    "com":"ems",    "num":"em263999513jp",    "phone":"13868688888",    "from":"广东省深圳市南山区金蝶软件园",    "to":"北京朝阳区国际金融大厦",    "show":"0",    "order":"desc",    "orderTime":"2020-12-16 12:59:59"  }

1.4 返回后果

字段名称	类型	字段含意
message	String	音讯体，请疏忽
state	Integer	快递单以后状态，包含0在途，1揽收，2疑难，3签收，4退签，5派件，6退回，7转单，10待清关，11清关中，12已清关，13清关异样，14收件人拒签等13个状态
status	Integer	通信状态，请疏忽
condition	String	快递单明细状态标记，暂未实现，请疏忽
ischeck	Integer	是否签收标记，请疏忽，明细状态请参考state字段
com	String	快递公司编码,一律用小写字母
nu	String	单号
trailUrl	String	轨迹地图链接
arrivalTime	String	预计达到工夫
totalTime	String	均匀耗时
remainTime	String	达到还需多少工夫
isLoop	Boolean	是否存在环路
routeInfo		路由信息
└from		出发地行政区信息
└number		政区信息编码
└name		政区信息名
└cur		以后地行政区信息
└number		政区信息编码
└name		政区信息名
└to		目的地行政区信息
└number		政区信息编码
└name		政区信息名
data	data	最新查问后果，数组，蕴含多项，全量，倒序（即工夫最新的在最前），每项都是对象，对象蕴含字段请开展
└ context	String	内容
└ time	String	工夫，原始格局
└ ftime	String	格式化后工夫
└status	String	本数据元对应的签收状态，只有实时查问接口中提交resultv2标记后才会呈现
└areaCode	String	本数据元对应的行政区域的编码，只有实时查问接口中提交resultv2标记后才会呈现
└areaName	String	本数据元对应的行政区域的名称，只有实时查问接口中提交resultv2标记后才会呈现

1.5 提供数据内容

{    "message": "ok",    "nu": "YT4781863654577",    "ischeck": "1",    "com": "yuantong",    "status": "200",    "data": [{        "time": "2020-11-30 13:19:56",        "context": "圆通单干点【喵站】快件已达到财产金街院里3号底商驿站,联系电话18744663997",        "ftime": "2020-11-30 13:19:56",        "areaCode": null,        "areaName": null,        "status": "在途"    }, {        "time": "2020-09-12 17:40:58",        "context": "【广东省深圳市平湖公司】 已收件 取件人: 刘杰珍 (18128837173)",        "ftime": "2020-09-12 17:40:58",        "areaCode": "CN440307003000",        "areaName": "广东,深圳市,龙岗区,平湖",        "status": "揽收"    }],    "state": "3",    "condition": "00",    "routeInfo": {        "from": {            "number": "CN4403",            "name": "广东,深圳市"        },        "cur": {            "number": "CN6101",            "name": "陕西,西安市"        },        "to": {            "number": "CN6101",            "name": "陕西,西安市"        }    },    "isLoop": false,       "trailUrl":"https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3",    "arrivalTime": "2020-12-19 12:00",    "totalTime": "2天1小时",    "remainTime": "1天2小时"}

1.6 运单签收状态服务阐明

状态值	名称	含意
0	在途	快件处于运输过程中
1	揽收	快件已由快递公司揽收
2	疑难	快递100无奈解析的状态，或者是须要人工染指的状态，比方说收件人电话谬误。
3	签收	失常签收
4	退签	货物退回发货人并签收
5	派件	货物正在进行派件
6	退回	货物正处于返回发货人的途中
7	转投	货物转给其余快递公司邮寄
10	待清关	货物期待清关
11	清关中	货物正在清关流程中
12	已清关	货物已实现清关流程
13	清关异样	货物在清关过程中出现异常
14	拒签	收件人明确拒收

1.7 轨迹链接利用示例

1.8 谬误返回示例

{"result":false,"returnCode":"400","message":"找不到对应公司"}

信息代码	信息内容形容	起因及倡议解决形式
200	查问胜利	查问胜利
400	参数权限问题	数据不残缺，找不到对应公司，非法IP，请申请受权，不反对此快递公司，单号问题等
500	查问无后果，请隔段时间再查	示意查问失败，去快递公司没获取无效数据
501	服务器谬误	快递100的服务器出理间隙或临时性异样，有时如果因为不按标准提交申请，比方快递公司参数没有依照文档规定填写等，也会报此谬误
502	服务器忙碌	快递100的服务器出理间隙或临时性异样，请分割快递100排查起因
503	验证签名失败	请查看加密形式，param + key + customer 的程序进行MD5加密，加密后字符串转大写
601	没该性能权限	没有可用单量或没有开启权限

一、快递查问地图轨迹API产品介绍

快递100快递查问地图轨迹接口提供给企业及最终用户快递单号的地图轨迹展现、物流节点文字信息及预计送达工夫，可视化展现物流轨迹信息。

通过调用地图轨迹接口，可展现地图轨迹、物流节点信息、预计达到工夫、快递单状态等信息，多样化物流信息展现维度，进步客户查问体验。

二、快递查问地图轨迹API利用场景

在电商网页/APP/小程序中，顾客在订单详情里查看购买商品的物流地图轨迹；
和物流轨迹文字信息一起展现给顾客，可视化订单的在途状态；
取得物流路径城市的信息，监控快递时效；
预估包裹的达到工夫，以及提醒包裹还需多长时间达到，辨认快递状态·，发送揭示客户签收短信；

三、快递查问地图轨迹API免费模式

1.免费形式

快递查问地图轨迹属于增值类服务，该服务同时反对物流文字信息以及地图链接，即蕴含了实时查问接口的性能。注册快递100企业账号后能够在企业治理后盾查看地图轨迹套餐价格并购买。

2.免费价格

新品限时特惠，流动工夫：2021年1月1日-2021年3月31日，充值后即可开明应用。

原价/元	优惠价/元	单量	赠送/单	优惠单价/元
~~3000~~	2000	20000	5000	0.08
~~1500~~	1000	10000	2000	约0.084
~~750~~	500	5000	500	约0.09
~~150~~	100	1000		0.1

快递查问地图轨迹按单计费，一个天然月内同一个运单屡次查问只收一次费用。该接口独自计费。

3.开具发票

快递100反对开具增值税发票，用户购买实现后可在企业治理后盾-费用核心-领取记录-申请开票。默认开具电子增值税普通发票，1000元以上可反对开具增值税专用发票。

官网源文档：

http://api.kuaidi100.com/docu...

一、 快递查问地图轨迹