快递单号查询自动识别API提供快递单号自动识别快递物流公司,支持顺丰、中通、圆通、圆通、韵达、百世、邮政、EMS快递单号自动识别,只需快递单号,即可查询418家国内外快递物流轨迹。
单号识别API为用户提供单号识别快递公司服务,依托于快递鸟大数据平台,用户提供快递单号,即可实时返回可能的一个或多个快递公司,存在多个快递公司结果的,大数据平台根据可能性、单号量,进行智能排序。
API参数
一、接口描述/说明
(1)该接口仅对运单号做出识别,识别可能属于的一家或多家快递公司。
(2)接口并不返回物流轨迹,用户可结合即时查询接口和订阅查询接口完成轨迹查询、订阅的动作。
(3)接口识别会返回一家或者多家快递公司,返回的数据根据快递鸟大数据分析结果排序,排名靠前的命中率更高。
(4)若识别失败,快递鸟返回的匹配结果为空。
(5)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):“application/x-www-form-urlencoded;charset=utf-8”。
(6)接口地址: API测试地址::8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址:/Ebusiness/EbusinessOrderHandle.aspx
备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)
二、接口参数
请求内容字段定义:
参数名称类型说明是否必须LogisticCodeString物流单号R
返回参数定义:
参数名称类型说明必须要求EBusinessIDString电商用户IDRLogisticCodeString物流单号RSuccessBool成功与否RCodeInt失败原因OShipperShipperCodeString快递公司编码OShipperNameString快递公司名称O
三、示例
请求示例 JSON
{"LogisticCode": "3967950525457" }
返回示例 JSON
{"EBusinessID": "1257021","Success": true,"LogisticCode": "3967950525457","Shippers": [{"ShipperCode": "YD","ShipperName": "韵达快递"}]}
demo下载地址:
接口接入技术文档
点击获取文档
单号识别接口Demo工具.NET版
单号识别接口Demo工具.PHP版
单号识别接口Demo工具.JAVA版
接入流程
1、登录快递鸟官网注册页面注册快递鸟账号
网址:快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册
2、登录快递鸟用户管理后台
网址:用户登录_快递鸟API让物流接口对接更简单
注:登录快递鸟用户管理后台后获得用户ID和APIKey,此用于保证应用来源的可靠性,避免应用伪造,被不法使用。
3、进入“我的会员中心”进行实名认证
注:
3.1、认证类型、应用类型根据用户实际情况选择即可,接口返回数据与选择结果无关;
3.2、标记为*的为必填,要求上传清晰、jpg格式且小于2M的证件图片;
3.3、技术对接人信息为用户方对接工程师的信息;
3.4、如有其他疑问可进入官网加入商务合作群进行咨询。
认证成功后,进入“产品服务管理”,开通相关会员服务
注:
物流查询(免费版)会员套餐为免费版,有效期1年结束后,如在近3个月内有数据交互系统会自动免费续期;
4、单号识别接口对接重点说明(RequestType:2002)
请求接口之前需要先实名认证,开通相关会员服务,否则会请求失败并返回提示“未申请开通接口”;
接口开发可以下载“快递鸟接口技术文档”进行参考;单号识别,参考技术文档中的4.4部分;
接口开发可以下载“单号识别demo”进行参考(仅提供了.NET、Java、PHP三种语言的demo);使用其他语言开发的用户需按照技术文档自行开发;
接入过程中如有疑问请先参考快递鸟官网常见问题进行解决(/help),也可以进入快递鸟官网加入技术对接群进行咨询。
注:快递鸟官网-帮助与文档地址(/documents)