上一篇
爱查快递api ajax
- 行业动态
- 2025-05-06
- 4687
利用AJAX异步请求爱查快递API,获取快递数据并动态展示
爱查快递API简介
爱查快递API是一款提供快递信息查询服务的接口,支持多家快递公司单号跟踪,通过AJAX技术可实现异步请求,无需刷新页面即可获取快递物流数据。
AJAX调用爱查快递API核心步骤
步骤 | 说明 | 代码示例 |
---|---|---|
构建请求URL | 组合API基础地址、快递公司编码、单号等参数 | https://api.ickd.cn/?id=YOUR_ID&com=shunfeng&nu=SF123456789 |
创建XMLHttpRequest对象 | 初始化AJAX请求 | javascript<br>var xhr = new XMLHttpRequest(); |
配置请求方法和URL | 设置GET请求及目标API地址 | xhr.open('GET', apiUrl); |
发送请求 | 向服务器发送请求 | xhr.send(); |
处理响应 | 接收并解析JSON格式数据 | xhr.onload = function(){ console.log(JSON.parse(xhr.responseText)); } |
关键参数说明表
参数名 | 说明 | 必填 | 示例值 |
---|---|---|---|
id | 用户授权ID | 是 | 10001 |
com | 快递公司编码 | 是 | yichang |
nu | 快递单号 | 是 | KY123456789CN |
show | 显示类型(0=文字,1=HTML) | 否 | 0 |
m | 返回格式(json/xml) | 否 | json |
order | 排序方式(desc/asc) | 否 | desc |
完整示例代码
<!DOCTYPE html> <html> <head>快递查询</title> </head> <body> <input type="text" id="trackingNumber" placeholder="输入快递单号"> <button onclick="query()">查询</button> <div id="result"></div> <script> function query(){ var nu = document.getElementById('trackingNumber').value; var apiUrl = `https://api.ickd.cn/?id=YOUR_ID&com=yuantong&nu=${nu}&show=0&m=json`; var xhr = new XMLHttpRequest(); xhr.open('GET', apiUrl); xhr.onload = function(){ if(xhr.status === 200){ var data = JSON.parse(xhr.responseText); if(data.status === 'ok'){ document.getElementById('result').innerHTML = formatResult(data.data); }else{ alert('查询失败:' + data.reason); } }else{ alert('网络错误:' + xhr.status); } } xhr.send(); } function formatResult(data){ let html = `<h3>${data.com} ${data.nu}</h3><ul>`; data.info.forEach(item => { html += `<li>${item.time} [${item.context}] ${item.location}</li>`; }); html += `</ul>`; return html; } </script> </body> </html>
常见问题与解决方案
Q1:跨域请求被阻止怎么办?
A1:爱查快递API默认支持CORS跨域请求,若仍出现跨域问题,可尝试:
- 检查API地址是否正确
- 使用JSONP方式请求(需将
m
参数改为jsonp
) - 联系服务商开通跨域白名单
Q2:返回数据为空或状态异常如何处理?
A2:排查流程:
- 确认单号是否正确且已揽收
- 检查
com
参数是否匹配快递公司编码表 - 验证
id
参数是否有效 - 查看响应码说明:
| 状态码 | 说明 |
|——–|——|
| ok | 查询成功 |
| error | 参数错误 |
| null | 无结果 |
| empty | 单号未收录 |
快递公司编码对照表(常用)
公司名称 | 编码 | 公司名称 | 编码 |
---|---|---|---|
顺丰速运 | shunfeng | 圆通速递 | yuantong |
中通快递 | zhongtong | 韵达快递 | yunda |
申通快递 | shentong | 百世快递 | best |
EMS | ems | 天天快递 |