如有转载,请标明来自此出处http://blog.csdn.net/qxs965266509,必须注意!
爱查快递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 | xmlencode可选gbk(默认)| utf8ord可选asc(默认)|desc,返回结果排序lang可选en返回英文结果,目前仅支持部分快递(ems、顺丰、dhl)注意:使用php的json_decode函数时必须使用utf8的编码,如果出现json_decode失败,请尝试使用utf8编码。返回格式格式:json | text | html | xml
编码:gbk| utf8
示例:{status:3,message:,errcode:0,data:[{time:2013-02-23 17:10,context:辽宁省大连市中山区四部公司 的收件员 王光 已收件},{time:2013-02-24 17:59,context:辽宁省大连市公司 已收入},{time:2013-02-24 18:11,context:辽宁省大连市中山区四部公司 已收件},{time:2013-02-26 07:33,context:吉林省长春市景阳公司 的派件员 张金达 派件中 派件员电话15948736487},{time:2013-02-26 16:47,context:客户 同事收发家人 已签收 派件员 张金达}],html:,mailno:7151900624,exptextname:圆通快递,expspellname:yuantong,update:1362656241,cache:186488,ord:asc}字段说明字段类型说明statusint查询结果状态,0|1|2|3|4,0表示查询失败,1正常,2派送中,3已签收,4退回,5其他问题errcodeint错误代码,0无错误,1单号不存在,2验证码错误,3链接查询服务器失败,4程序内部错误,5程序执行错误,6快递单号格式错误,7快递公司错误,10未知错误messagestring错误消息dataarray进度htmlstring其他html,该字段不一定存在mailnostring快递单号expspellnamestring快递公司英文代码exptextnamestring快递公司中文名updateint最后更新时间(unix 时间戳)cacheint缓存时间,当前时间与 update 之间的差值,单位为:秒ordstring排序,asc | descphp应用示例
若服务器禁用了file_get_contents和fsockopen等函数,可使用curl类,示例如下:
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.readystate4 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.number0 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
%>