首页 > 编程 > PHP > 正文

快递鸟查询Api接口使用(PHP版)

2020-03-22 18:49:00
字体:
来源:转载
供稿:网友
这篇文章主要介绍了关于快递鸟查询Api接口使用(PHP版),有着一定的参考价值,现在分享给大家,有需要的朋友可以参考一下


前提

项目开发中,有些需求难免会用到关于快递的一些Api接口;本篇主要介绍的是快递的查询Api及与其他各家的不同之处;

常用的提供快递Api接口的有:

  1. 快递鸟

  2. 快递100

  3. 爱查快递
    等等

如大家使用过,快递100和爱查快递等等网站提供的快递查询等接口时,你会发现,你所申请的账号或key每天调用Api接口的次数都是被限制的,有的是2000次/天,有的是5000次/次;唯一让你感到麻烦的是,要求用户添加外链,而快递鸟不需要用户添加外链。对于无门户网站的用户,无非就是很苛刻的要求;并且,超出部分需付费才能使用。

快递鸟,请求Api接口是不限制次数的哟,并且永久免费

固然,对于你小小的需求的话,快递100和爱查快递都可满足你的需求;但是,当万一某天请求次数太多,你的查询服务就得停止,影响你的产品体验;所以,推荐你直接使用快递鸟,一步到位。

应用场景

查询订单的物流信息

此处输入图片的描述

可实现需求
  1. App中直接集成实现快递物流信息查询Api接口

  2. 在微信公众号中,根据用户输入的订单号,我们的后台识别订单号并根据快递鸟查询快递Api接口,实现自动查询的功能

  3. 等等

申请Key

http://www.kdniao.com/ServiceApply.aspx

按照你的信息,依次把信息填写完整,点击提交申请即可。

登录成功后,就可以看到ID和key等信息,有这些信息就可以请求查询等其他的接口Api

此处输入图片的描述

快递查询Api接口

接口文档及各开发语言Demo

查询Api接口定义

系统级输入参数
参数名称类型必须要求说明
RequestDataStringR请求内容,JSON或XML格式,须和DataType一致EBusinessIDStringR用户IDRequestTypeStringR请求指令类型:1002DataSignStringR数据内容签名DataTypeStringO请求、返回数据类型:1-xml,2-json;默认为xml格式

应用级输入参数
参数名称类型必须要求说明
OrderCodevarchar(50)O订单编号ShipperCodevarchar(10)R快递公司编码LogisticCodevarchar(50)R物流单号

返回结果参数
参数名称类型必须要求说明
EBusinessIDIntR电商用户IDOrderCodeVarchar(50)O订单编号ShipperCodevarchar(10)R快递公司编码LogisticCodeVarchar(50)R物流运单号SuccessBoolR成功与否ReasonVarchar(50)O失败原因StateIntR物流状态1:已取件2:在途中3:签收TracesVarchar(Max)R物流轨迹详情

物流轨迹详情

参数名称类型必须要求说明
AcceptTimeDateTimeR时间AcceptStationVarchar(50)R描述RemarkVarchar(150)O备注

请求JSON参数
{    "OrderCode" : "",    "ShipperCode" : "SF",    "LogisticCode" : "118650888018"}

响应JSON参数
{    "EBusinessID" : "1109259",    "OrderCode" : "",    "ShipperCode" : "SF",    "LogisticCode" : "118461988807",    "Success" : true,    "State" : 3,    "Reason" : null,    "traces" : [{            "AcceptTime" : "2014/06/25 08:05:37",            "AcceptStation" : "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",            "Remark" : null        }, {            "AcceptTime" : "2014/06/25 04:01:28",            "AcceptStation" : "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",            "Remark" : null        }, {            "AcceptTime" : "2014/06/25 01:41:06",            "AcceptStation" : "快件在 深圳集散中心 [深圳市]",            "Remark" : null        }, {            "AcceptTime" : "2014/06/24 20:18:58",            "AcceptStation" : "已收件[深圳市]",            "Remark" : null        }, {            "AcceptTime" : "2014/06/24 20:55:28",            "AcceptStation" : "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]",            "Remark" : null        }, {            "AcceptTime" : "2014/06/25 10:23:03",            "AcceptStation" : "派件已签收[深圳市]",            "Remark" : null        }, {            "AcceptTime" : "2014/06/25 10:23:03",            "AcceptStation" : "签收人是:已签收[深圳市]",            "Remark" : null        }    ]}

查询Api接口使用

以PHP开发语言为例,进行展开

<?php//电商IDdefined('EBusinessID') or define('EBusinessID', '请到快递鸟网址申请http://kdniao.com/reg');//电商加密私钥,快递鸟提供,注意保管,不要泄漏defined('AppKey') or define('AppKey', '请到快递鸟网址申请http://kdniao.com/reg');//请求urldefined('ReqURL') or define('ReqURL', 'http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx');//调用查询物流轨迹//---------------------------------------------$logisticResult=getOrderTracesByJson();echo logisticResult;//--------------------------------------------- /** * Json方式 查询订单物流轨迹 */function getOrderTracesByJson(){$requestData= "{'OrderCode':'','ShipperCode':'YTO','LogisticCode':'12345678'}";$datas = array(        'EBusinessID' => EBusinessID,        'RequestType' => '1002',        'RequestData' => urlencode($requestData) ,        'DataType' => '2',    );    $datas['DataSign'] = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);//根据公司业务处理返回的信息......return $result;} /** *  post提交数据  * @param  string $url 请求Url * @param  array $datas 提交的数据  * @return url响应返回的html */function sendPost($url, $datas) {    $temps = array();    foreach ($datas as $key => $value) {        $temps[] = sprintf('%s=%s', $key, $value);    }    $post_data = implode('&', $temps);    $url_info = parse_url($url);if(empty($url_info['port'])){$url_info['port']=80;}    $httpheader = "POST " . $url_info['path'] . " HTTP/1.0/r/n";    $httpheader.= "Host:" . $url_info['host'] . "/r/n";    $httpheader.= "Content-Type:application/x-www-form-urlencoded/r/n";    $httpheader.= "Content-Length:" . strlen($post_data) . "/r/n";    $httpheader.= "Connection:close/r/n/r/n";    $httpheader.= $post_data;    $fd = fsockopen($url_info['host'], $url_info['port']);    fwrite($fd, $httpheader);    $gets = "";$headerFlag = true;while (!feof($fd)) {if (($header = @fgets($fd)) && ($header == "/r/n" || $header == "/n")) {break;}}    while (!feof($fd)) {$gets.= fread($fd, 128);    }    fclose($fd);          return $gets;}/** * 电商Sign签名生成 * @param data 内容    * @param appkey Appkey * @return DataSign签名 */function encrypt($data, $appkey) {    return urlencode(base64_encode(md5($data.$appkey)));}?>

其他Api接口,请转到快递鸟具体查看相关文档。

温馨提示

如你的产品需对接或集成快递接口,快递鸟是不错的选择;会给您提供专业的技术支持人员;查询次数不限,并永久免费。

以上就是快递鸟查询Api接口使用(PHP版)的详细内容,更多请关注 其它相关文章!

郑重声明:本文版权归原作者所有,转载文章仅为传播更多信息之目的,如作者信息标记有误,请第一时间联系我们修改或删除,多谢。

发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表