API Professional Service
快递查询
快递查询,我们致力于为用户提供专业的免费 API 数据接口服务
返回接口列表
GET
快递查询
v1.0最后更新:
免费
调用次数:15
正常运行
响应速度:1180 ms
无需API密钥
快递查询
快递物流查询接口,数据来自快递100,支持全国 812 家快递物流公司的运单轨迹查询,涵盖顺丰、京东、中通、圆通、申通、韵达、极兔、EMS、邮政、德邦、跨越、壹米滴答、安能、宅急送等主流快递,纯文本输出。运单号可自动识别快递公司,也可用 com 参数精确指定;顺丰、中通、德邦等需补充收件人手机号后四位(phone)。返回内容包括当前状态(在途中/派件中/已签收/拒签等)与按时间倒序排列的完整物流轨迹。调用示例:https://api.qsxfr.top/API/kdcx.php?num=运单号
总调用:15
今日:15
格式:application/json
接口地址
https://api.qsxfr.top/API/kdcx.php
请求地址
https://api.qsxfr.top/API/kdcx.php?num=
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| num | string | 必填 | 运单号,6-40 位字母或数字(也可用 postid / nu 参数名) |
| com | string | 可选 | 快递公司编码,如 shunfeng、zhongtong;不填则自动识别,传 list=1 可查看全部编码 |
| phone | string | 可选 | 收件人手机号后 4 位,顺丰、中通、德邦等部分快递需要 |
| list | string | 可选 | 传 1 返回支持的全部快递公司编码表(812 家) |
num *
string运单号,6-40 位字母或数字(也可用 postid / nu 参数名)
com
string快递公司编码,如 shunfeng、zhongtong;不填则自动识别,传 list=1 可查看全部编码
phone
string收件人手机号后 4 位,顺丰、中通、德邦等部分快递需要
list
string传 1 返回支持的全部快递公司编码表(812 家)
在线测试
返回结果
点击「发送请求」按钮,查看接口返回结果
返回码说明
| 返回码 | 说明 |
|---|---|
| 正常 | 查询成功,返回当前状态与完整物流轨迹 |
| -1 | 参数错误:缺少运单号、运单号格式不对、快递公司编码不支持 |
| -2 | 未查询到物流信息(运单号未录入或快递公司判断有误) |
| -3 | 上游快递查询服务异常,请稍后重试 |
正常
查询成功,返回当前状态与完整物流轨迹
-1
参数错误:缺少运单号、运单号格式不对、快递公司编码不支持
-2
未查询到物流信息(运单号未录入或快递公司判断有误)
-3
上游快递查询服务异常,请稍后重试
多语言调用示例
授权提醒:本接口及其示例代码需经本站站长授权后方可使用,支持按 域名 或 IP 授权。
未授权的域名与 IP 调用接口将无法正常获取数据。如需授权请联系 QQ:
1747470487
cURL
curl -X GET "https://api.qsxfr.top/API/kdcx.php?num=&num=your_num&com=your_com&phone=your_phone&list=your_list"
Python
import requests
url = "https://api.qsxfr.top/API/kdcx.php?num="
params = {
'num': 'your_num',
'com': 'your_com',
'phone': 'your_phone',
'list': 'your_list'
}
response = requests.get(url, params=params)
print(response.text)
PHP
<?php
$url = "https://api.qsxfr.top/API/kdcx.php?num=";
$params = [
'num' => 'your_num',
'com' => 'your_com',
'phone' => 'your_phone',
'list' => 'your_list'
];
$full_url = $url . (strpos($url, '?') === false ? '?' : '&') . http_build_query($params);
$result = file_get_contents($full_url);
echo $result;
?>
JavaScript
// 使用 fetch 发送GET请求
const url = new URL('https://api.qsxfr.top/API/kdcx.php?num=');
url.searchParams.append('num', 'your_num');
url.searchParams.append('com', 'your_com');
url.searchParams.append('phone', 'your_phone');
url.searchParams.append('list', 'your_list');
fetch(url)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error('请求失败:', err));
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ApiRequest {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
String url = "https://api.qsxfr.top/API/kdcx.php?num=";
// 拼接请求参数
url += "?" + "num=your_num&com=your_com&phone=your_phone&list=your_list";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
.thenApply(HttpResponse::body)
.thenAccept(System.out::println)
.join();
}
}
Go
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
baseUrl := "https://api.qsxfr.top/API/kdcx.php?num="
parsedUrl, _ := url.Parse(baseUrl)
q := parsedUrl.Query()
q.Set("num", "your_num");
q.Set("com", "your_com");
q.Set("phone", "your_phone");
q.Set("list", "your_list");
parsedUrl.RawQuery = q.Encode()
resp, err := http.Get(parsedUrl.String())
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
C#
using System;
using System.Net.Http;
using System.Collections.Generic;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
var url = new Uri("https://api.qsxfr.top/API/kdcx.php?num=");
var queryParams = new Dictionary<string, string>();
queryParams.Add("num", "your_num");
queryParams.Add("com", "your_com");
queryParams.Add("phone", "your_phone");
queryParams.Add("list", "your_list");
var uriBuilder = new UriBuilder(url);
uriBuilder.Query = new FormUrlEncodedContent(queryParams).ReadAsStringAsync().Result;
url = uriBuilder.Uri;
var response = await client.GetAsync(url);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
}
}
Shell
# 使用curl发送GET请求
curl -X GET "https://api.qsxfr.top/API/kdcx.php?num=&num=your_num&com=your_com&phone=your_phone&list=your_list"
API Key 配置说明
=== API Key 使用说明 ===
1. 在本站注册账号并登录
2. 进入用户中心 → API密钥 → 申请API Key
3. 管理员审核通过后获得 apikey
4. 调用接口时在URL参数中添加 apikey 参数
示例:
https://api.qsxfr.top/API/kdcx.php?num=&apikey=你的apikey
注意事项:
- 请勿将 apikey 泄露给他人
- 如发现 apikey 泄露,请及时在用户中心申请删除
- 每个 apikey 有调用频率限制,请合理使用
词库
# Secluded/QRspeed/ClousX6
A:$访问 https://api.qsxfr.top/API/kdcx.php?num=&num=your_num&com=your_com&phone=your_phone&list=your_list$
Kotlin
import okhttp3.FormBody
import okhttp3.OkHttpClient
import okhttp3.Request
fun main() {
val client = OkHttpClient()
val url = "https://api.qsxfr.top/API/kdcx.php?num="
// GET 请求拼接参数
val requestBuilder = Request.Builder().url(url + "?" + "num=your_num&com=your_com&phone=your_phone&list=your_list")
val request = requestBuilder.get().build()
client.newCall(request).execute().use { response ->
if (!response.isSuccessful) throw RuntimeException("请求失败: ${response.code}")
println(response.body?.string())
}
}