zoukankan      html  css  js  c++  java
  • 快递单号查询快递鸟API接口-邮政国内标快

    调用快递鸟提供的快递查询API标准接口,快速对接100多家快递公司的物流轨迹查询,本篇文章实现<邮政国内标快>的快递单号查询

    首先我们准备好需要用到的资源,

    这里推荐大家去爱奇艺查看视频教程:

    https://www.iqiyi.com/v_19rxcwtwk0.html(如何从注册到认证,最快1小时完成上百家物流轨迹查询)

     

    测试商户ID

    test1617571

    测试API key

    554343b2-7252-439b-b4eb-1af42c8f2175(Key仅限测试环境使用)

    API测试地址:

    http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

     

    接下来,我们讲解一下请求参数

    一、接口描述/说明

    请求系统级参数说明:

    参数名称

    类型

    说明

    必须要求

    RequestData

    String

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

    R

    EBusinessID

    String

    商户ID,请在我的服务页面查看。

    R

    RequestType

    String

    请求指令类型:1002

    R

    DataSign

    String

    数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo

    R

    DataType

    String

    请求、返回数据类型:2-json

    O

    备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional

    这里提到了系统级参数,也相当于是公用参数,这些参数是调用每个接口都是必须要传参的。

     

    二、接口参数

    请求内容字段定义:

    参数名称

    类型

    说明

    必须要求

    OrderCode

    String

    订单编号

    O

    ShipperCode

    String

    快递公司编码

    R

    LogisticCode

    String

    物流单号

    R

    CustomerName

    String

    寄件人或收件人的手机号后四位数字

    R

     

    接口参数,也叫业务参数,请求的业务接口不同,参数的字段,内容也不同,是跟着业务变化的,这里我们实现的是即时查询接口,请求指令类型:1002快递鸟官网要求必须传递快递公司编码和物流单号 ,全一快递的编码是UAPEX

    如要查看其他快递公司的编码,点击此链接:

    http://www.kdniao.com/documents

     

    我们用邮政国内标快的真实单号(1187763739690)来完成快递单号查询接口的调用,

    请求的完整报文(URL编码以后):RequestData=+%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27YZBK%27%2c%27LogisticCode%27%3a%271187763739690%27%7d&EBusinessID=1264783&RequestType=1002&DataSign=YjFkNzY2ZTNhNjY3NTM0ODZhZmM4ZTRjYjczNDVlNGQ%3d&DataType=2

    URL解码的请求报文:

    RequestData= {'OrderCode':'','ShipperCode':'YZBK','LogisticCode':'1187763739690'}&EBusinessID=1264783&RequestType=1002&DataSign=YjFkNzY2ZTNhNjY3NTM0ODZhZmM4ZTRjYjczNDVlNGQ=&DataType=2

     

    返回参数定义:

    参数名称

    类型

    说明

    必须要求

    EBusinessID

    String

    用户ID

    R

    OrderCode

    String

    订单编号

    O

    ShipperCode

    String

    快递公司编码

    R

    LogisticCode

    String

    物流运单号

    O

    Success

    Bool

    成功与否

    R

    Reason

    String

    失败原因

    O

    State

    String

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

    R

    Traces

    AcceptTime

    String

    时间

    R

    AcceptStation

    String

    描述

    R

    Remark

    String

    备注

    O

     

    返回报文信息

    -{ "LogisticCode" : "1187763739690", "ShipperCode" : "YZBK", "Traces" : [ { "AcceptStation" : "[南昌市]【南昌市向塘揽投部】已收件,揽投员:赵文萍,电话:15070872285", "AcceptTime" : "2020-03-02 14:16:12" }, { "AcceptStation" : "[南昌市]离开【南昌市向塘揽投部】,下一站【南昌邮件处理中心】", "AcceptTime" : "2020-03-02 16:21:43" }, { "AcceptStation" : "[南昌市]离开【南昌邮件处理中心】,下一站【武汉邮件处理中心】", "AcceptTime" : "2020-03-03 07:52:46" }, { "AcceptStation" : "[武汉市]到达【武汉邮件处理中心】(经转)", "AcceptTime" : "2020-03-03 15:42:12" }, { "AcceptStation" : "[武汉市]离开【武汉邮件处理中心】,下一站【黄冈包件处理班】(经转)", "AcceptTime" : "2020-03-04 04:55:54" }, { "AcceptStation" : "[黄冈市]到达【黄冈包件处理班】", "AcceptTime" : "2020-03-04 09:21:08" }, { "AcceptStation" : "[黄冈市]离开【黄冈包件处理班】,下一站【湖北黄梅县处理中心】", "AcceptTime" : "2020-03-05 09:23:40" }, { "AcceptStation" : "[黄冈市]【湖北黄梅县处理中心】安排投递,投递员:郝金娇,电话:19871949550,揽投部电话:15071681008", "AcceptTime" : "2020-03-05 13:55:42" } ], "State" : "2", "EBusinessID" : "1264783", "Success" : true }

    附上详细的接口文档给大家:

    http://www.kdniao.com/documents

    提供源码下载:

    https://download.csdn.net/download/yanghanwen/12139326

    调用第三方物流接口,替换自己的key就能直接使用,主要实现了物流在线轨迹查询,订单订阅,轨迹推送,支持上百家家的快递查询接口,包括主流的四通一达,支持上门取件服务,其他接口调用,修改调用指令和参数就能实现。

    源码运行演示截图:

     

  • 相关阅读:
    SharePoint 2013 安装.NET Framework 3.5 报错
    SharePoint 2016 配置工作流环境
    SharePoint 2016 站点注册工作流服务报错
    Work Management Service application in SharePoint 2016
    SharePoint 2016 安装 Cumulative Update for Service Bus 1.0 (KB2799752)报错
    SharePoint 2016 工作流报错“没有适用于此应用程序的地址”
    SharePoint 2016 工作流报错“未安装应用程序管理共享服务代理”
    SharePoint JavaScript API in application pages
    SharePoint 2016 每天预热脚本介绍
    SharePoint 无法删除搜索服务应用程序
  • 原文地址:https://www.cnblogs.com/51api/p/12422000.html
Copyright © 2011-2022 走看看