极兔速递单号查询接口对接指南

极兔速递品牌介绍

J&T极兔速递是一家科技创新型互联网快递物流企业，致力于为用户带来优质的快递和物流体验。2015年8月由印尼首都雅加达作为起点，进入快递物流市场，目前覆盖了印度尼西亚、越南、马来西亚、泰国、菲律宾、柬埔寨及新加坡七个国家，成为东南亚超过5.5亿人口信赖的综合性物流服务商。

 

 

J&T 极兔速递是东南亚首家以互联网配送为核心业务的科技型快递公司，业务涉及快递、快运、仓储及供应链等多元化领域，业务类型涵盖同城、跨省及国际件。

 

极兔速递品牌实力

J&T Express 成立以来，已全面覆盖印尼、越南、马来西亚、菲律宾、泰国、柬埔寨、新加坡等国家。

 

 

J&T 极兔速递依靠J&T Express在东南亚7国成熟的网络布局，具备较强的跨境快递先发优势；

 

J&T 极兔速递以互联网为核心，具备较强的科技优势；

 

极兔的经营模式以直营为主，代理为辅，城郊或边缘地区会开放一二级代理，但全部归总公司管理。除此之外，J&T 极兔速递独特的代理合伙人机制确保快递高效运营，真正实现企业与代理合作伙伴的双赢。

 

目前快递鸟API已经支持极兔速递API接口对接，把源码复制到你的项目上，就能快速完成极兔快递接口对接,调用快递鸟的极兔快递查询API接口，能查询到极兔快递单号从收件、运输，到转运中心，派送到签收等各个环节的物流发货状态。快递鸟api接口不区分开发语言，支持Java，C#，PHP，Python，ObjectC等开发语言的程序调用。

 

下面具体讲解实现过程

 

1.完成前期准备工作

1.1,去快递鸟官网免费注册一个账号

 

1.2,免费获得一个apiKey(接口权限验证需要)

 

1.3,完成实名认证流程

 

1.4,订购一个免费套餐

 

2.API接口

2.1,测试调用地址http://sandboxapi.kdniao.:8080/kdniaosandbox/gateay/exterfaceInvoke.json

 

2.2,正式调用地址http://api.kdniao./api/dist

 

2.3,请求方式POST

 

2.4,编码格式(utf-8)application/x--form-urlencoded;charset=utf-8

 

2.5,返回类型JSON

 

2.6,调试页面http://kdniao./UserCenter/v2/SandBox/TrackQuery.aspx

 

2.7,调试工具去调试（使用快递鸟账号登录）

 

3.请求参数（Headers）

 

4.请求参数（Body）

 

5.请求完整报文（示例）

RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JTSD%27%2c%27LogisticCode%27%3a%27

jt0000052600488%27%7d&EBusessID=1264783&RequestType=1002&DataSign=MTYyMDU4NWQ2NmU1ZDI2MDEzNGE5YmV

lM2YxYzEzMTM%3d&DataType=2

6.成功返回报文（示例）

{

    "LogisticCode": "JT0000052600488",

    "ShipperCode": "JTSD",

    "Traces": [

        {

            "AeptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件",

            "AeptTime": "2020-03-16 16:26:13"

        },

        {

            "AeptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件",

            "AeptTime": "2020-03-16 16:41:33"

        },

        {

            "AeptStation": "【芜湖市】【芜湖镜湖网点】已收件",

            "AeptTime": "2020-03-16 17:39:21"

        },

        {

            "AeptStation": "【芜湖市】快件离开【芜湖镜湖网点】已发往【芜湖转运中心】",

            "AeptTime": "2020-03-16 17:40:27"

        },

        {

            "AeptStation": "【芜湖市】快件到达【芜湖转运中心】",

            "AeptTime": "2020-03-16 19:36:32"

        },

        {

            "AeptStation": "【芜湖市】快件离开【芜湖转运中心】已发往【合肥转运中心】",

            "AeptTime": "2020-03-16 20:47:03"

        },

        {

            "AeptStation": "【合肥市】快件到达【合肥转运中心】",

            "AeptTime": "2020-03-16 23:40:10"

        },

        {

            "AeptStation": "【合肥市】快件离开【合肥转运中心】已发往【广州花都转运中心】",

            "AeptTime": "2020-03-17 00:10:48"

        },

        {

            "AeptStation": "【广州市】快件到达【广州花都转运中心】",

            "AeptTime": "2020-03-17 20:45:00"

        },

        {

            "AeptStation": "【广州市】快件离开【广州花都转运中心】已发往【深圳宝安转运中心】",

            "AeptTime": "2020-03-18 00:17:55"

        },

        {

            "AeptStation": "【深圳市】快件到达【深圳宝安转运中心】",

            "AeptTime": "2020-03-18 03:00:17"

        },

        {

            "AeptStation": "【深圳市】快件离开【深圳宝安转运中心】已发往【深圳福田网点】",

            "AeptTime": "2020-03-18 04:44:39"

        },

        {

            "AeptStation": "【深圳市】【深圳福田网点】的邹俊林 17679495647正在派件",

            "AeptTime": "2020-03-18 08:10:09"

        },

        {

            "AeptStation": "【深圳市】【深圳福田网点】的赵凯 15919817730正在派件",

            "AeptTime": "2020-03-18 09:55:19"

        },

        {

            "AeptStation": "【深圳市】快件已签收，签收人是【代收】，如有疑问请联系15919817730，期待为您服务",

            "AeptTime": "2020-03-18 14:53:54"

        }

    ],

    "State": "3",

    "EBusessID": "1264783",

    "Suess": true

}

 

 

7.失败返回报文（示例）

 

{

"LogisticCode": "JT0000052600488",

"ShipperCode": "JTSD",

"Traces": [],

"State": "0",

"EBusessID": "1264783",

"Reason": "业务错误[没有可用套餐]",

"Suess": false

}

说明未实名认证，未订购套餐，套餐可用查询量已经用完 都会返回此报文信息

 

8.无轨迹返回报文（示例）

 

{

"LogisticCode": "JT0000052600488",

"ShipperCode": "JTSD",

"Traces": [],

"State": "0",

"EBusessID": "1264783",

"Reason": "暂无轨迹信息",

"Suess": true

}