圆通快递单号查询接口物流路由跟踪信息快递鸟api对接教程

看完快递鸟api对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成圆通快递接口对接.更适合刚入门的菜鸟,调用快递鸟的圆通快递查询API接口,能查询到圆通快递单号从收件、运输,到转运中心,派送到签收等各个环节的物流发货状态。快递鸟api接口不区分开发语言,支持Java,C#,PHP,Python,ObjectC等开发语言的程序调用。下面具体讲解实现过程.

1.完成前期准备工作

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

1.2,免费获得一个apiKey(接口权限验证需要), 获取用户ID和ApiKey

1.3,完成实名认证流程,去认证

1.4,订购一个免费套餐,去订购

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

2.7,调试工具:去调试(使用快递鸟账号登录)

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 快递公司编码,圆通:YTO 必填
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=%0d%0a++++++++++++%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27YTO%27%2c%27LogisticCode%27%3a%27YT4313813113511%27%7d%0d%0a++++++++&EBusinessID=1617571&RequestType=1002&DataSign=YjUxYzNlYTBiMjYwYjIzZjE4ZGQ4ZjgyYjJhNGRiZjQ%3d&DataType=2

7.成功返回报文(示例)

{
    "LogisticCode": "YT4313813113511",
    "ShipperCode": "YTO",
    "Traces": [{
        "AcceptStation": "【山东省青岛市胶州市公司】 已收件 取件人: 张富强 (18521137295)",
        "AcceptTime": "2019-12-29 18:15:41"
    }, {
        "AcceptStation": "【山东省青岛市胶州市公司】 已打包",
        "AcceptTime": "2019-12-29 18:41:22"
    }, {
        "AcceptStation": "【山东省青岛市胶州市】 已发出 下一站 【青岛转运中心公司】",
        "AcceptTime": "2019-12-29 18:44:43"
    }, {
        "AcceptStation": "【青岛转运中心公司】 已收入",
        "AcceptTime": "2019-12-29 19:40:51"
    }, {
        "AcceptStation": "【青岛转运中心】 已发出 下一站 【深圳转运中心公司】",
        "AcceptTime": "2019-12-29 20:10:01"
    }, {
        "AcceptStation": "【深圳转运中心公司】 已收入",
        "AcceptTime": "2019-12-31 13:39:41"
    }, {
        "AcceptStation": "【深圳转运中心】 已发出 下一站 【广东省深圳市宝安区机场公司】",
        "AcceptTime": "2019-12-31 14:04:58"
    }, {
        "AcceptStation": "【广东省深圳市宝安区机场公司】 已收入",
        "AcceptTime": "2020-01-01 01:43:02"
    }, {
        "AcceptStation": "【广东省深圳市宝安区机场公司】 派件中 派件人: 罗家宁 电话 13924819329 如有疑问,请联系:0755-27393821",
        "AcceptTime": "2020-01-01 09:36:26"
    }, {
        "AcceptStation": "客户签收人: B5超人 已签收 感谢使用圆通速递,期待再次为您服务 如有疑问请联系:13924819329,投诉电话:0755-27393821",
        "AcceptTime": "2020-01-02 12:52:32"
    }],
    "State": "3",
    "EBusinessID": "1617571",
    "Success": true
}

8.失败返回报文(示例)

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

说明:未实名认证,未订购套餐,套餐可用查询量已经用完 都会返回此报文信息
去实名认证 / 了解套餐详情

9.无轨迹返回报文(示例)

{
"LogisticCode": "295734066970",
"ShipperCode": "YTO",
"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\":\"SF\",\"LogisticCode\":\"118461988807\"}" ;

//把(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.圆通快递查询接口应用效果

12.关于签名

快递鸟和第三方电子商务公司系统进行对接,有一定的安全机制。采用 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 相当于密码。 

13.返回码定义

编码 说明
100 成功
101 缺少必要参数
102 校验问题
103 格式问题

原文地址:https://www.cnblogs.com/51api/p/12460394.html

时间: 2024-10-08 00:44:51

圆通快递单号查询接口物流路由跟踪信息快递鸟api对接教程的相关文章

中通快递-单号查询接口-物流路由跟踪信息快递鸟api对接教程

前言 看完快递鸟api对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成中通快递接口对接.更适合刚入门的菜鸟,调用快递鸟的中通快递查询API接口,能查询到中通快递单号从收件.运输,到转运中心,派送到签收等各个环节的物流发货状态.快递鸟api接口不区分开发语言,支持Java,C#,PHP,Python,ObjectC等开发语言的程序调用.下面具体讲解实现过程. 目录 1.完成前期准备工作 2.API接口 3.请求参数(Headers) 4.请求参数(Body) 5.返回参数(Return)

快递单号查询接口-极兔速递

前言看完快递鸟api极兔快递对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成极兔快递接口对接.更适合刚入门的菜鸟,调用快递鸟的极兔快递查询API接口,能查询到极兔快递单号从收件.运输,到转运中心,派送到签收等各个环节的物流发货状态.快递鸟api接口不区分开发语言,支持Java,C#,PHP,Python,ObjectC等开发语言的程序调用.下面具体讲解实现过程.1.完成前期准备工作1.1,去快递鸟官网免费注册一个账号 1.2,免费获得一个apiKey(接口权限验证需要) 1.3,完成实

免费顺丰快递单号查询电子面单api接口对接【快递鸟API】

顺丰速运快递查询接口API和电子面单接口怎么对接?除了通过顺丰自己的接口对接外,用的最多的就是第三方通过快递鸟对接了,通过顺丰单号和手机号后四位查询轨迹信息,如果是通过快递鸟下单获得的顺丰单号,可通过单号直接查询,具体下载快递鸟接口技术文档查看接口说明.ShipperCode为SF,且快递单号非快递鸟渠道返回时,必填,对应收件人/寄件人手机号后四位:ShipperCode为SF,且快递单号为快递鸟渠道返回时,不填. 一.接入前准备(TO商家业务人员) 1.申请快递鸟用户ID和API key1.1

快速实现常用快递单号查询api接口对接方法

网上的物流快递查询接口有很多,但是大部分都比较麻烦.所以这里介绍一个比较简单的查询方法,不需要对接友情链接,免费获取api接口技术文档以及demo 主要是利用 快递鸟的免费查询api接口: 快递鸟是全球最大的第三方快递物流接口服务商, 目前已经集成了418家快递单号查询接口,31家电子面单接口.高实时.高稳定.高并发,支持快递单号自动识别. 快递鸟第三方快递查询接口很好用,关键免费,使用的用户很多(有十几个千人技术QQ群),大的ERP基本都用的是快递鸟的接口,非淘系的电商平台也都是用快递鸟提供的

免费物流快递单号查询接口快速对接指南

[场景需求描述] 电商平台及ISV商家对物流api接口的需求有很多,今天我们主要分享的就是快递鸟快递单号查询接口的对接指南,快递单号查询接口对接的应用场景有很多,很多场景会遇到,最主要的就是电商网站用户打开"我的订单"时调用此API显示物流信息详情,电商管理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题,电商平台对商家物流管控,要求必须在多久快递必须发出要看到揽件状态,多久必须收到货物看到签收状态,根据这些状态对商家管控从而提高用户的整体满意度.下图是电商平台.买家.商

如何快速搭建快递单号查询网站!

最近公司有这样的需求,需要对公司的电子商城集成快递单号查询服务,后来本打算自己开发,但是到网上逛了圈后发现,有已经开发好的快递查询接口, 我嘴角歪了歪,不用白不用,先用快递一百的试试,仔细看了下接口说明,本打算用的时候看到对申通快递,ems快递只能html返回,哎感觉不符合公司的要求,后来到另一个网站爱快递申请了个快递接口,感觉还不错,至少现在没看出毛病,帖下接口快递单号查询地址www.aikuaidi.cn,方便下次查阅. 如何快速搭建快递单号查询网站!,布布扣,bubuko.com

SHOPEX快递单号查询插件圆通V8.2专版

SHOPEX快递物流单号查询插件特色 本SHOPEX快递物流单号跟踪插件提供国内外近2000家快递物流订单单号查询服务例如申通快递.顺丰快递.圆通快递.EMS快递.汇通快递.宅急送快递.德邦物流.百世快递.汇通快递.中通快递.天天快递等知名快递订单查询服务, 另有全球各国邮局邮政.国内国际小包等接口查询, 现已很好的整合在SHOPEX里,只要简单几步即可实现SHOPEX商城用户实时查看订单物流信息,有效的增加了客户体验! 安装方法 步骤一:将您服务器中的ShopEx程序的\core\shop\v

ECSHOP快递单号查询插件圆通V8.2专版

本ECSHOP快递物流单号跟踪插件提供国内外近2000家快递物流订单单号查询服务例如申通快递.顺丰快递.圆通快递.EMS快递.汇通快递.宅急送快递.德邦物流.百世快递.汇通快递.中通快递.天天快递等知名快递订单查询服务, 另有全球各国邮局邮政.国内国际小包等接口查询, 现已很好的整合在ECSHOP里,只要简单三步即可实现SHOPEX商城用户实时查看订单物流信息,有效的增加了客户体验! 安装方法 第1步:申请授权KEY 本插件采用曲阜市快车网络科技http://www.17cx.com/提供的免费

常用快递单号查询api接口对接案例(快递鸟&amp;菜鸟)

目前提供快递查询的接口平台有: 快递鸟 (非淘系用户使用最多) 菜鸟 (淘系用户使用) 不同接口的区别: (1)快递鸟支持400多家物流快递公司,接口稳定免费,提供多种方式接口对接 (2)菜鸟支持100多家物流快递公司接口,主要支持阿里淘系商家用户使用. 快递API的应用场景与用途 最常见的应用场景如下: (1)电商网站:例如B2C.团购.B2B.批发分销站.C2C.本地生活交易等网站. (2)管理系统:订单处理平台.订货平台.发货平台.分销系统.渠道管理系统.客户管理系统.ERP等. 快递AP