授权成功我的密钥
爱查快递API使用说明文档
API地址:
以前:http://api.ickd.cn/?com=[]&nu=[]&id=[]&type=[]&encode=[]&ord=[]&lang=[]
目前:http://api.ickd.cn/?id=[]&secret=[]&com=[]&nu=[]&type=[]&encode=[]&ord=[]&lang=[]
参数说明
字段 | 是否必须 | 说明 |
---|---|---|
com | 必须 | 快递公司代码(英文),所支持快递公司见如下列表 |
nu | 必须 | 快递单号,长度必须大于5位 |
id secret |
必须 必须 |
授权的id 授权KEY,申请请点击快递查询API申请方式 |
type | 可选 | 返回结果类型,值分别为 html | json(默认) | text | xml |
encode | 可选 | gbk(默认)| utf8 |
ord | 可选 | asc(默认)|desc,返回结果排序 |
lang | 可选 | en返回英文结果,目前仅支持部分快递(EMS、顺丰、DHL) |
返回格式
编码:GBK| UTF8
示例:
字段说明
字段 | 类型 | 说明 |
---|---|---|
status | int | 查询结果状态,0|1|2|3|4,0表示查询失败,1正常,2派送中,3已签收,4退回,5其他问题 |
errCode | int | 错误代码,0无错误,1单号不存在,2验证码错误,3链接查询服务器失败,4程序内部错误,5程序执行错误,6快递单号格式错误,7快递公司错误,10未知错误 |
message | string | 错误消息 |
data | array | 进度 |
html | string | 其他HTML,该字段不一定存在 |
mailNo | string | 快递单号 |
expSpellName | string | 快递公司英文代码 |
expTextName | string | 快递公司中文名 |
update | int | 最后更新时间(unix 时间戳) |
cache | int | 缓存时间,当前时间与 update 之间的差值,单位为:秒 |
ord | string | 排序,ASC | DESC |
php应用示例
<script language="javascript"> <?php $id='xxxxxxxxxxxxxxxxx';//到http://www.ickd.cn/api/reg.html申请 $url='http://api.ickd.cn/?com=shentong&nu=588035733628&id='.$id; $data=file_get_contents($url); //echo "var data='",$data,"'"; ?> $(function(){ var dataObj=<?=$data?>;//转换为json对象 var html='<tr>'; html+='<th>物流状态:</th>'; html+='<td>'; if(dataObj.status>0){ html+='<table width="520px" cellspacing="0" cellpadding="0" border="0" style="border-collapse: collapse; border-spacing: 0pt;">'; html+='<tr>'; html+='<td width="163" style="background-color:#e6f9fa;border:1px solid #75c2ef;font-size:14px;font-weight:bold;height:20px;text-indent:15px;">'; html+='时间'; html+='</td>'; html+='<td width="354" style="background-color:#e6f9fa;border:1px solid #75c2ef;font-size:14px;font-weight:bold;height:20px;text-indent:15px;">'; html+='地点和跟踪进度'; html+='</td>'; html+='</tr>'; //输出data的子对象变量 $.each(dataObj.data,function(idx,item){ html+='<tr>'; html+='<td width="163" style="border:1px solid #dddddd;font-size: 12px;line-height:22px;padding:3px 5px;">'; html+=item.time;// 每条数据的时间 html+='</td>'; html+='<td width="354" style="border:1px solid #dddddd;font-size: 12px;line-height:22px;padding:3px 5px;">'; html+=item.context;// 每条数据的状态 html+='</td>'; html+='</tr>'; }); html+='</table>'; }else{ //查询不到 html+='<span style="color:#f00">Sorry! '+dataObj.message+'</span>'; } html+='</td></tr>'; $("#shipping_detail").append(html); }); </script>
<?php $id='xxxxxxxxxxxxx';//API KEY $com='shunfeng';//快递公司 $nu='123456';//快递单号 $type='json'; $encode='utf8'; $gateway=sprintf('http://api.ickd.cn/?id=%s&com=%s&nu=%s&encode=%s&type=%s',$id,$com,$nu,$encode,$type); $ch=curl_init($gateway); curl_setopt($ch,CURLOPT_RETURNTRANSFER,true); curl_setopt($ch,CURLOPT_HEADER,false); $resp=curl_exec($ch); $errmsg=curl_error($ch); if($errmsg){ exit($errmsg); } curl_close($ch); echo $resp; ?>
ASP应用示例
<%
Response.Charset="gb2312"
Server.ScriptTimeout = 999999999
Dim Retrieval
Dim url,nu,com
com = Request("com")'公司
nu = Request("nu")'单号
Dim AppKey,SendURL,ResponseTxt
AppKey = "xxxxxxxxxx" '请将XXXXXX替换成您在http://www.ickd.cn/reg.html申请到的KEY
SendURL ="http://api.ickd.cn/?id="&AppKey&"&com="&com&"&nu="&nu&"&type=json&encode=GBK"'如果使用UTF8,请确保encode=utf8
'Response.Write SendURL
'发送数据
ResponseTxt=fopen(SendURL) '//获取源代码的函数
'调用发送数据组件
Function fopen(URL)
Dim objXML
'Set objXML=CreateObject("MSXML2.SERVERXMLHTTP.3.0") '调用XMLHTTP组件,若服务器不支持,请换用以下两个中的一个再试
Set objXML=Server.CreateObject("Microsoft.XMLHTTP")
'Set objXML=Server.CreateObject("MSXML2.XMLHTTP.4.0")
'objXML.SetTimeouts 5000, 5000, 30000, 10000' 解析DNS名字的超时时间,建立Winsock连接的超时时间,发送数据的超时时间,接收response的超时时间。单位毫秒
objXML.Open "GET",URL,False '以同步方式获取API查询数据
objXML.Send() '发送
If objXML.Readystate<>4 Then '状态不为4,错误
Response.Write "{status:0,errCode:100,message:'获取数据出错'}"
Exit Function
End If
'Readystate属性,传回XML文件资料的目前状况,返回值分别有以下:
'0-UNINITIALIZED:XML 对象被产生,但没有任何文件被加载。
'1-LOADING:加载程序进行中,但文件尚未开始解析。
'2-LOADED:部分的文件已经加载且进行解析,但对象模型尚未生效。
'3-INTERACTIVE:仅对已加载的部分文件有效,在此情况下,对象模型是有效但只读的。
'4-COMPLETED:文件已完全加载,代表加载成功。
fopen=objXML.ResponseBody
fopen=BytesToBstr(objXML.ResponseBody)'返回信息,同时用函数定义编码,如果您需要转码请选择
Set objXML=Nothing'关闭
If Err.number<>0 Then
Response.Write "{status:0,errCode:100,message:'获取数据出错'}"
Err.Clear
End If
End Function
'页面编码转换
Function BytesToBstr(body)
Dim objstream
Set objstream = Server.CreateObject("Adodb.Stream") '//调用adodb.stream组件
objstream.Type = 1
objstream.Mode =3
objstream.Open
objstream.Write body
objstream.Position = 0
objstream.Type = 2
objstream.Charset = "GBK" '转换原来默认的编码转换成GB2312编码,否则直接用XMLHTTP调用有中文字符的网页得到的将是乱码
BytesToBstr = objstream.ReadText
objstream.Close
Set objstream = Nothing
End Function
'输入查询结果
Response.Write ResponseTxt
%>
目前所支持的快递公司列表
点击查看最新列表
快递公司 | 代码 |
EMS快递 | ems |
申通快递 | shentong |
圆通快递 | yuantong |
中通快递 | zhongtong |
汇通快递 | huitong |
天天快递 | tiantian |
韵达快递 | yunda |
顺丰快递 | shunfeng |
宅急送快递 | zhaijisong |
CCES快递 | cces |
中国邮政平邮 | pingyou |
星晨急便 | xingchen |
速尔快递 | sure |
快捷快递 | kuaijie |
中铁快运 | zhongtie |
AAE快递 | aae |
安捷快递 | anjie |
安信达快递 | anxinda |
程光快递 | chengguang |
大田物流 | datian |
德邦物流 | debang |
DHL快递 | dhl |
DPEX快递 | dpex |
D速快递 | dsu |
国际Fedex | fedex |
Fedex国内 | fedexcn |
原飞航物流 | feihang |
丰达快递 | fengda |
飞康达快递 | fkd |
飞快达快递 | fkdex |
天地华宇物流 | huayu |
佳吉快运 | jiaji |
佳怡物流 | jiayi |
加运美快递 | jiayunmei |
晋越快递 | jinyue |
联昊通物流|快递 | lianhaotong |
龙邦快递 | longbang |
民航快递 | minhang |
港中能达 | nengda |
OCS快递 | ocs |
全晨快递 | quanchen |
全峰快递 | quanfeng |
全日通快递 | quanritong |
全一快递 | quanyi |
如风达快递 | rufeng |
盛丰物流 | shengfeng |
盛辉物流 | shenghui |
TNT快递 | tnt |
UPS | ups |
万家物流 | wanjia |
新邦物流 | xinbang |
鑫飞鸿速递 | xinfeihong |
信丰快递 | xinfeng |
亚风快递 | yafeng |
一邦快递 | yibang |
优速快递 | yousu |
远成物流 | yuancheng |
元智捷诚 | yuanzhi |
越丰快递 | yuefeng |
运通中港快递 | yuntong |
源伟丰 | ywfex |
中邮物流 | zhongyou |