当前位置: 首页 > Web前端 > HTML

快递100快递实时查询接口API案例代码

时间:2023-04-02 18:08:07 HTML

1.实时快递查询接口1.1请求地址

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

1.2请求类型post1.3inputParameter请求参数(header)NameTypeDefaultValueContent-Typestringapplication/x-www-form-urlencoded请求参数(body)NameTypeRequiredExampleValue说明customerString为授权码,请申请企业版获取signString为验证Identity的签名,按照param+key+customer的顺序进行MD5加密(注意加密后的字符串一定要转为32位大写),无需加“+”号ΘparamObject拼接其他字段└comstring为圆通Code查询的快递公司,全部为小写下载编码表└numstring为12345678查询的快递单号,单号最大长度为32个字符└phonestring为13888888888收寄件人电话(手机和座机都可以,只能填一个,需要顺丰快递单号,其他快递公司可选)。如果座机号码有分机号码,分机号码不需要上传。)└fromstring否广东深圳出发城市└tostring否北京朝阳目的城市,到达目的地后,增加监听频率└resultv2int否1添加该字段表示启用行政区域分析功能。0:禁用(默认),1:启用行政区域分析功能和物流轨迹增加物流状态值,2:启用行政区域分析功能和物流轨迹增加物流状态值并返回出发地,目的地和当前城市信息└showString否0返回格式:0:json格式(默认),1:xml,2:html,3:text└orderString否desc返回结果排序:desc降序(默认),asc升序1.4请求参数示例客户=***********sign=*******************param={"com":"ems","num":"em263999513jp","phone":"13868688888","from":"广东省深圳市南山区","to":"北京市朝阳区","resultv2":"1","show":"0","order":"desc"}1.5返回结果字段名称类型字段含义messageString邮件正文,请忽略stateInteger快递订单当前状态,包括0在途,1收到,2困难,3签收,4撤回,5派送,6退回,7中转单,10待清关,11清关,12清关,13清关异常,14收件人拒收等13状态status整数通讯状态,请忽略conditionString快递单明细statusflag,暂未实现,请无视ischeckInteger是否签收,请无视,详细状态请参考状态字段comString快递公司代码,全部为小写字母nuString单号Θdatadata最新查询结果,数组,包含多项,全量,倒序(即最新时间在前),每一项都是一个对象,对象包含字段,请展开└contextString内容└timeString时间,原始格式└fTimeString格式化时间└statusString该数据元对应的签到状态只有在实时查询界面提交resultv2标签后才会出现└areaCodeString该数据元对应的行政区域代码只有在resultv2之后才会出现实时查询界面提交tag└areaNameString实时查询界面提交resultv2标记后,才会出现该数据元素对应的行政区域名称。Receive2DifficultExpress100无法解决的状态,或者需要人工干预的状态,比如收件人电话号码错误3正常签收4签收货物退回发货人并签收5货物正在派送中6退回货物正在返回发货人的途中7货物中转其他快递公司邮寄10待清关货物等待清关11清关进行中货物正在清关中12已清关货物已完成清关流程13清关异常货物在海关有异常清关流程14拒收,收件人明确拒收1.7正确返回示例JSON格式{"message":"ok","state":"0","status":"200","condition":"F00","ischeck":"0","com":"yuantong","nu":"V030344422","data":[{"context":"上海配送中心/加载扫描","time":"2012-08-2816:33:19","ftime":"2012-08-2816:33:19",},{"context":"上海配送中心/下车扫描","time":"2012-08-2723:22:42","ftime":"2012-08-2723:22:42",}]}1.8错误返回示例JSON格式{"result":false,"returnCode":"400","message":"Couldnotfindthecorrespondingcompany"}1.8信息代码含义信息代码信息内容说明原因及建议处理方法200查询成功查询成功400找不到对应的公司提交的资料不完整或账号没有已充值查看提交信息格式是否为x-www-form-urlencoded,post格式500查询无结果,请稍等片刻再查看,说明查询失败,或者没有POST提交501服务器ErrorExpress100服务器出现空档或临时异常,有时如果是由于未按规范提交请求,例如快递公司参数未按单据填写等。,也会报这个错502serverisbusy快递100的服务器出现处理间隙或临时异常请联系快递100排查原因503验证签名失败请检查加密方法,param的顺序+密钥+客户使用MD5加密。加密后字符串转为大写601,密钥已过期,无可用订单。账户需要充值。2.快递公司代码下载表格3.Demo下载JAVA示例代码PHP示例代码PYTHON示例代码.NET示例代码一、实时查询API产品介绍Express100实时查询接口为企业和终端用户提供实时查询物流轨迹的功能。用户将快递单号提交到实时查询界面后,实时查询界面会实时调取快递公司的单号信息,并返回该单号的最新物流信息,包括物流轨迹、状态、时间等2、实时查询API应用场景在电商网页/APP/小程序中,客户在订单详情中查询所购商品的物流轨迹;客服人员实时查询订单轨迹,确保商品配送状态正常;公司邮寄礼品、文件等,业务人员根据运单号跟踪派送状态,确保签收;可集成到网站、APP、ERP、SAAS平台、小程序中;由于快递公司系统承压能力有限,请勿大量、高频、重复调用该接口。仅在贵公司网站或APP终端用户主动点击触发调用该接口查询时使用。其他系统自动更新运单因收货状态等管理需要,请继续使用快递100信息推送服务。注意:对于实时查询接口,请控制每笔订单的查询频率至少半小时,否则会造成锁单。官方源码文档:http://api.kuaidi100.com/docu...https://api.kuaidi100.com/doc...http://api.kuaidi100.com/docu...