当前位置:首页 > 行业动态 > 正文

爱查快递api ajax

利用AJAX异步请求爱查快递API,获取快递数据并动态展示

爱查快递API简介

爱查快递API是一款提供快递信息查询服务的接口,支持多家快递公司单号跟踪,通过AJAX技术可实现异步请求,无需刷新页面即可获取快递物流数据。

爱查快递api ajax  第1张


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跨域请求,若仍出现跨域问题,可尝试:

  1. 检查API地址是否正确
  2. 使用JSONP方式请求(需将m参数改为jsonp
  3. 联系服务商开通跨域白名单

Q2:返回数据为空或状态异常如何处理?
A2:排查流程:

  1. 确认单号是否正确且已揽收
  2. 检查com参数是否匹配快递公司编码表
  3. 验证id参数是否有效
  4. 查看响应码说明:
    | 状态码 | 说明 |
    |——–|——|
    | ok | 查询成功 |
    | error | 参数错误 |
    | null | 无结果 |
    | empty | 单号未收录 |

快递公司编码对照表(常用)

公司名称 编码 公司名称 编码
顺丰速运 shunfeng 圆通速递 yuantong
中通快递 zhongtong 韵达快递 yunda
申通快递 shentong 百世快递 best
EMS ems 天天快递
api
0