极兔快递 | 快递单号查询API

已于 2022-11-02 17:11:55 修改
阅读量3.9k 收藏 1
点赞数
分类专栏： 快递物流查询 API接口 快递查询接口 文章标签： javascript 前端 服务器
于 2022-11-02 16:38:14 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/KuaiDNiao/article/details/127653560
版权

本期讲解：极兔快递查询快递单号的方法。

纯干货，强烈建议收藏/转发给技术人员和管理人员学习。

提供源码，复制到你的项目上,就能快速完成快递鸟的极兔快递查询API接口。

下面具体讲解实现过程：

1.完成前期准备工作

1.1,注册快递鸟账号

1.2,apiKey(接口权限验证需要)

1.3,完成实名认证

2.API接口

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

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

2.3,请求方式：POST

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

2.5,返回类型：JSON

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

3.请求参数（Headers）

参数名称

类型

说明

必须要求

RequestData

String

请求内容需进行URL(utf-8)编码,请求内容JSON格式，须和DataType一致

必填

EBusinessID

String

用户ID，查看用户ID和ApiKey

必填

RequestType

String

请求指令类型：1002

必填

DataSign

String

签名数据，(Body+ApiKey)进行MD5加密，再进行Base64编码，最后进行URL(utf-8)编码

必填

DataType

String

求、返回数据类型：2-json ，默认Json

选填

4.请求参数（Body）

参数名称

类型

说明

必须要求

OrderCode

String

订单编号

选填

ShipperCode

String

快递公司编码，中通：ZTO

必填

LogisticCode

String

物流运单号

必填

5.返回参数（Return）

参数名称

类型

说明

必须要求

EBusinessID

String

用户ID

必填

ShipperCode

String

快递公司编码

必填

LogisticCode

String

物流运单号

选填

Success

String

成功与否

必填

Reason

String

失败原因

选填

State

String

物流状态：2-在途中,3-签收,4-问题件

必填

Traces

String

时间

AcceptTime

String

必填

AcceptStation

String

描述

选填

Remark

String

备注

必填

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

RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JTSD%27%2c%27LogisticCode%27%3a%27jt0000052600488%27%7d&EBusinessID=1264783
&RequestType=1002&DataSign=MTYyMDU4NWQ2NmU1ZDI2MDEzNGE5YmV
lM2YxYzEzMTM%3d&DataType=2

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

{
    "LogisticCode": "JT0000052600488",
    "ShipperCode": "JTSD",
    "Traces": [
        {
            "AcceptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件",
            "AcceptTime": "2020-03-16 16:26:13"
        },
        {
            "AcceptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件",
            "AcceptTime": "2020-03-16 16:41:33"
        },
        {
            "AcceptStation": "【芜湖市】【芜湖镜湖网点】已收件",
            "AcceptTime": "2020-03-16 17:39:21"
        },
        {
            "AcceptStation": "【芜湖市】快件离开【芜湖镜湖网点】已发往【芜湖转运中心】",
            "AcceptTime": "2020-03-16 17:40:27"
        },
        {
            "AcceptStation": "【芜湖市】快件到达【芜湖转运中心】",
            "AcceptTime": "2020-03-16 19:36:32"
        },
        {
            "AcceptStation": "【芜湖市】快件离开【芜湖转运中心】已发往【合肥转运中心】",
            "AcceptTime": "2020-03-16 20:47:03"
        },
        {
            "AcceptStation": "【合肥市】快件到达【合肥转运中心】",
            "AcceptTime": "2020-03-16 23:40:10"
        },
        {
            "AcceptStation": "【合肥市】快件离开【合肥转运中心】已发往【广州花都转运中心】",
            "AcceptTime": "2020-03-17 00:10:48"
        },
        {
            "AcceptStation": "【广州市】快件到达【广州花都转运中心】",
            "AcceptTime": "2020-03-17 20:45:00"
        },
        {
            "AcceptStation": "【广州市】快件离开【广州花都转运中心】已发往【深圳宝安转运中心】",
            "AcceptTime": "2020-03-18 00:17:55"
        },
        {
            "AcceptStation": "【深圳市】快件到达【深圳宝安转运中心】",
            "AcceptTime": "2020-03-18 03:00:17"
        },
        {
            "AcceptStation": "【深圳市】快件离开【深圳宝安转运中心】已发往【深圳福田网点】",
            "AcceptTime": "2020-03-18 04:44:39"
        },
        {
            "AcceptStation": "【深圳市】【深圳福田网点】的邹俊林 17679495647正在派件",
            "AcceptTime": "2020-03-18 08:10:09"
        },
        {
            "AcceptStation": "【深圳市】【深圳福田网点】的赵凯 15919817730正在派件",
            "AcceptTime": "2020-03-18 09:55:19"
        },
        {
            "AcceptStation": "【深圳市】快件已签收，签收人是【代收】，如有疑问请联系：15919817730，期待再次为您服务",
            "AcceptTime": "2020-03-18 14:53:54"
        }
    ],
    "State": "3",
    "EBusinessID": "1264783",
    "Success": true}

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

{
    "LogisticCode": "JT0000052600488",
    "ShipperCode": "JTSD",
    "Traces": [],
    "State": "0",
    "EBusinessID": "1264783",
    "Reason": "业务错误[没有可用套餐]",
    "Success": false
}

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

{
    "LogisticCode": "JT0000052600488",
    "ShipperCode": "JTSD",
    "Traces": [],
    "State": "0",
    "EBusinessID": "1264783",
    "Reason": "暂无轨迹信息",
    "Success": true
}

10.分步讲解（C#版本）

10.1，请求数据包结构

10.2,C#调用代码示例

//电商ID
string eEBusinessID = "test1617571";
 //电商加密私钥，快递鸟提供，注意保管，不要泄漏
string appKey= "554343b2-7252-439b-b4eb-1af42c8f2175";
 //请求url
string reqURL = "http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json";
//请求指令 
string reqType="1002";
//2-json 
string dataType = "2"; 
//字符编码采用UTF-8 
string charset = "UTF-8"; 
//JSON字符串string 
string jsonStr = 
"{\"OrderCode\":\"\",\"ShipperCode\":\"JTSD\",\"LogisticCode\":\"JT0000052600488\"}" ;
//把(jsonStr+APIKey)进行MD5加密
string md5Str=MD5(jsonStr + apiKey, charset);
//把md5Str 进行Base64编码
string base64Str=base64(md5Str,charset);
//进行URL编码 (utf-8)
string datasign = HttpUtility.UrlEncode(base64Str, charset); 
//请求报文参数 
string postStr = "RequestType=reqType&EBusinessID= eEBusinessID&RequestData=jsonStr 
&DataSign= datasign&DataType=dataType"; 
//通讯协议使用Http协议Post请求方式 返回轨迹数据
string post = SendPost(reqURL, postStr);
//获取到的post数据就是快递鸟返回的完整报文，接下来自己写一个解析json的方法就能获取到里面的字段信息。

10.3,C#调用方法

///<summary>
    /// 字符串MD5加密
    ///</summary>
    ///<param name="str">要加密的字符串</param>
    ///<param name="charset">编码方式</param>
    ///<returns>密文</returns>
    private string MD5(string str, string charset)
    {
        byte[] buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(str);
        try
        {
            System.Security.Cryptography.MD5CryptoServiceProvider check;
            check = new System.Security.Cryptography.MD5CryptoServiceProvider();
            byte[] somme = check.ComputeHash(buffer);
            string ret = "";
            foreach (byte a in somme)
            {
                if (a < 16)
                    ret += "0" + a.ToString("X");
                else
                    ret += a.ToString("X");
            }
            return ret.ToLower();
        }
        catch
        {
            throw;
        }
    }
    /// <summary>
    /// base64编码
    /// </summary>
    /// <param name="str">内容</param>
    /// <param name="charset">编码方式</param>
    /// <returns></returns>
    private string base64(String str, String charset)
    {
        return Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));}
 /// <summary>
    /// Post方式提交数据，返回网页的源代码
    /// </summary>
    /// <param name="url">发送请求的 URL</param>
    /// <param name="postData">请求报文参数</param>
    /// <returns>远程资源的响应结果</returns>
    private string SendPost(string url, string postData)
    {
        string result = "";
        byte[] byteData = Encoding.GetEncoding("UTF-8").GetBytes(postData.ToString());
        try
        {
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
            request.ContentType = "application/x-www-form-urlencoded";
            request.Referer = url;
            request.Accept = "*/*";
            request.Timeout = 30 * 1000;
            request.UserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET
 CLR 2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729)";
            request.Method = "POST";
            request.ContentLength = byteData.Length;
            Stream stream = request.GetRequestStream();
            stream.Write(byteData, 0, byteData.Length);
            stream.Flush();
            stream.Close();
            HttpWebResponse response = (HttpWebResponse)request.GetResponse();
            Stream backStream = response.GetResponseStream();
            StreamReader sr = new StreamReader(backStream, Encoding.GetEncoding("UTF-8"));
            result = sr.ReadToEnd();
            sr.Close();
            backStream.Close();
            response.Close();
            request.Abort();
        }
        catch (Exception ex)
        {
            result = ex.ToString();
        }
        return result;
    }

11.关于签名

快递鸟和第三方电子商务公司系统进行对接，有一定的安全机制。采用 IP 认证加签名 的方式对接，具体方案如下：

防止数据被篡改 
在 POST 请求中会传递 5 个必须(R)参数 
RequestData==数据内容(URL 编码:UTF-8) EBusinessID==用户 ID 
RequestType=请求指令类型 
DataSign== 数据内容签名：把(请求内容(未编码)+ApiKey)进行 MD5 加密，然后 Base64 
编码，最后进行 URL(utf-8)编码 
DataType==2(返回数据类型为 json) 注：
DataSign 生成后，对方接收到数据后，以同样的算法进行签名(推送接口 RequestType 为 
101/102 不需要进行 URL 编码)，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生
数据篡改。 
调用接口的身份认证 
注册成为快递鸟用户后，会生成对应的用户 ID 和 APIKey，用户 ID 相当于用户名， 
APIKey 相当于密码。

12.返回码定义

编码

说明

100

成功

101

缺少必要参数

102

校验问题

103

格式问题

更多快递接口api技术干货、物流行业知识，关注我们的公众号【快递鸟API】（kuaidiniaoapi）。如果你觉得以上内容对你有用，欢迎点赞、评论、转发。你的认可是我持续分享的动力！

有不清楚的问题，欢迎大家留言一起探讨。

快递鸟
关注
专栏目录
极兔快递电子面单打印API接口-极兔快递
m0_61494784的博客
11-23 1万+
前言 J&T 极兔速递是一家科技创新型互联网快递物流企业，致力于为用户带来优质的快递和物流体验。 2015年8月由印尼首都雅加达作为起点，进入快递物流市场，目前覆盖了印度尼西亚、越南、马来西亚、泰国、菲律宾、柬埔寨及新加坡七个国家，成为东南亚超过5.5亿人口信赖的综合性物流服务商。 电子面单模板效果图： 电子面单打印模板规格列表： 快递公司名称 编码 模板样式 尺寸规格 Tem.
国内主流物流公司常用快递单号查询API接口全攻略
jessonine的博客
05-13 2313
此接口支持***顺丰、EMS、申通、圆通、韵达、汇通、中通、天天、德邦、极兔、京东、全峰***等主流快递公司 目的 便于快递鸟用户理解快递单号查询接口作用并正确应用到实际场景。 接口作用 轨迹类接口包含：即时查询接口和物流跟踪接口。 即时查询接口：实时查询某个快递单号当前的物流状态； 物流跟踪接口：监控某个快递单号完整的物流状态。 应用场景 可应用于电商平台、自营商城、ERP、打单工具、楼宇/物业系统、云打印、微信小程序/公众号、APP、OA等需要查看物流信息的场景。 接口逻辑 说明： 快递鸟接口作为数据
极兔API接口对接
XxpXxp422的博客
09-21 284
最近需要做一个项目，用到了极兔的API，是刚开始用这个，以前没有用过，学习了两天，感觉有一点收获，觉得对于初学者来说，可以试着参考。首先需要注册账号，没有账号是不能进入的，而且还需要提供公司信息。注册成功后，我刚开始一点概念也没有，就逼着自己去看里面的内容，看了一遍什么也不知道，就试着重复看了好几遍，反复的找资料，慢慢的看了好几遍，发现有点思路。
极兔快递单号查询API
软件开发
08-28 2万+
极兔快递单号查询API 1) 请求地址 https://official.jtexpress.com.cn/official/waybill/trackingCustomerByWaybillNo/v_3?waybillList=JT1252161236123 2) 调用方式：HTTP get 3) 接口描述： 接口描述详情 是正确订单号肯定可以查询 4) 请求参数: GET参数: 字段名称 字段说明 类型 必填 备注 waybillList .
多个极兔快递单号的物流信息要怎么同时查询
m77672471的博客
01-20 1804
多个极兔快递单号要怎么同时查询物流的详细信息呢？看看大家是怎么用软件来批量操作查询的吧。 先来看看查询后的物流整体情况 **准备软件：**快递批量查询高手软件 实例操作步骤 1、双击打开快递批量查询高手软件，再点击注册账号并登录。 2、单击添加单号。 3、打开极兔单号并复制到软件中。 4、选择快递公司“极兔快递”，并点击保存。 5、接着看到软件开始自动查询，只需耐心等待进度条走完即可。 6、查询完毕可以查看签收状态情况。 7、双击单号可以看该单号的具体运送信息。 ...
极兔速递查询，极兔速递物流查询，分析筛选出揽收中转延误件
qq_30187915的博客
11-09 412
批量查询极兔速递单号的物流信息，并将其中的揽收中转延误件(从“揽收”至“到达转运中心”之间的时间差超过24小时的单号)分析筛选出来。
极兔快递物流怎么批量查并将信息导出CSV表格
departed_saint的博客
02-21 1063
极兔快递是一家科技创新型的互联网快递企业，只要有快递单号，即可用快递批量查询高手，批量查询各个单号的物流，非常方便，下面一起来操作。 需要哪些工具？ 下载一个快递批量查询高手 多个极兔单号 怎么批量查询？ 打开快递批量查询高手，并登录（注册时介绍人请填写：与我） 登录后，在添加单号中，将收集好的单号一行一个的导入 单击保存，弹出一个提醒，因为小编测试只查询一家快递公司，可点“是”，手动选择快递公司 在对应的下拉列表中，选中“极兔快递”这个快递公司 然后软件自动回到主界面，开始查物流 查询好了，即可
极兔快递批量查询.rar
06-10
极兔快递批量查询工具是为了解决商家或个人一次性查询大量极兔快递单号的需求，提高效率，减少手动操作的繁琐。下面我们将详细探讨相关的知识点。 1. **极兔快递**：极兔快递是一家在全球范围内提供物流服务的公司...
物流行业批量快递查询Winform软件快递API接口集成应用支持批量查询智能识别1500多家快递公司单号
最新发布
08-11
批量查快递物流信息,批量导入快递单,顺丰快递,圆通快递,中通快递,韵达快递,中通快递,极兔快递,申通快递,国内国外快递单号都能查,软件集成了各大快递API接口服务商,快递100,快递鸟,阿里云,腾讯云,百度云购买的快递查...
快递单号查询接口对接-快递鸟API.net源码c#
09-17 1299
前言 看完快递鸟api对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成快递接口对接,调用快递鸟的极兔快递查询API接口，能查询到快递单号从收件、运输，到转运中心，派送到签收等各个环节的物流发货状态。快递鸟api接口不区分开发语言，支持Java，C#，PHP，Python，ObjectC等开发语言的程序调用。 下面具体讲解实现过程: 1.完成前期准备工作 1.1,去快递鸟官网免费注册一个账号 1.2,免费获得一个apiKey(接口权限验证需要) 1.3,完成实名认证流程 1.4,订购一个免费套餐 2
极兔快递单号查询 快递鸟API接口对接指南-极兔速递
快递鸟API
03-26 2万+
目录1.完成前期准备工作2.API接口3.请求参数（Headers）4.请求参数（Body）5.返回参数（Return）6.请求完整报文（示例）7.成功返回报文（示例）8.失败返回报文（示例）9.无轨迹返回报文（示例）10.分步讲解（C#版本）11.极兔快递查询接口应用效果12.关于签名13.返回码定义 看完快递鸟api极兔快递对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成极兔快递接口...
如何快速查询极兔快递并设置参数？
m0_71312938的博客
07-21 1897
如何快速查询极兔快递并设置参数？
对接极兔速递物流开放平台API接口指南-快递鸟
KuaiDNiao的博客
02-07 4009
快递鸟API接入实现效果，即时查询API，极兔速递跟踪信息，目前我们熟知的拼多多、商派、E店宝、管易云、美丽说、网店管家、万里牛等一直在用快递鸟。
对接极兔快递订阅查询物流
Moonhwa的博客
08-04 1231
对接极兔快递查询物流 对接极兔快递订阅物流
调用快递鸟API接口DataSign 签名加密技术文档
KuaiDNiao的博客
02-08 449
快递鸟和第三方电子商务公司系统进行对接，有一定的安全机制。采用 IP 认证加签名 的方式对接，注册成为快递鸟用户后，会生成对应的用户 ID 和 APIKey，用户 ID 相当于用户名，APIKey 相当于密码
极兔速递电子面单API接口-快递鸟
热门推荐
快递鸟API
05-14 13万+
目录 1.完成前期准备工作 2.API接口 3.请求完整报文（示例） 4.成功返回报文（示例） 5.失败返回报文（示例） 6.分步讲解（C#版本） 7.极兔速递电子面单打印模板内容（HTML） 8.关于签名 前言 J&T 极兔速递是一家科技创新型互联网快递物流企业，致力于为用户带来优质的快递和物流体验。 2015年8月由印尼首都雅加达作为起点，进入快递物流市场，目前覆盖了印度尼西亚、越南、马来西亚、泰国、菲律宾、柬埔寨及新加坡七个国家，成为东南亚超过5.5亿人口信赖的综合性物流服务商。 电子面单模板
GO 快递接口开发（快递鸟）
纪念本兮
02-21 1840
此文章纯属个人原因，本人是初学者，刚学习Golang 4个来月，如写的不好大神们就请绕行吧！ 最近公司需要些快递的接口，但是公司没有开发，我是个搞运维，一直在学GO，所以就试着写了写，也在网上找了很多资料，都没有找到需要的，字文章供GO 爱好者们玩耍，写的不好大神勿喷！不废话，上代码： 首先，导入包    然后，定义各种结构体、变量、常量 然后，处理请求内容，加密 ，初始化配置 ...
常用物流快递单号查询API接口对接net源码示例_快递鸟
firekj的博客
03-14 3487
零售电商平台及ISV商家对物流api接口的需求有很多，今天我们主要分享的就是快递鸟快递单号查询接口的对接指南，快递单号查询接口对接的应用场景有很多，很多场景会遇到，最主要的就是电商网站用户打开“我的订单”时调用此API显示物流信息详情，电商管理后台的物流系统，客服在对账前查询所有运单的签收状态，并追踪问题，电商平台对商家物流管控，要求必须在多久快递必须发出要看到揽件状态，多久必须收到货物看到签收状态，根据这些状态对商家管控从而提高用户的整体满意度。 调用快递鸟快递单号查询API接口，就能查询到1600多家以
顺丰快递单号查询接口物流路由跟踪信息快递鸟api对接教程
快递鸟API
03-11 7716
把源码复制到你的项目上,就能快速完成顺丰快递接口对接.更适合刚入门的菜鸟,调用快递鸟的顺丰快递查询API接口，能查询到顺丰快递单号从收件、运输，到转运中心，派送到签收等各个环节的物流发货状态。快递鸟api接口不区分开发语言，支持Java，C#，PHP，Python，ObjectC等开发语言的程序调用。
快递API查询服务：免费追踪各大快递单号
"快递API开发文档提供了国内1100多家快递公司的物流订单查询服务，包括申通、顺丰、圆通、EMS、汇通、宅急送等知名快递公司的查询服务。此外，还支持国内国际小包的接口查询。这个接口是完全免费的，适用于电子商城...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值