API 文档
-
接口地址:
https://apicx.asia/api/kuaidi
-
返回格式:
JOSN
-
请求方式:
GET
-
请求示例:
https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token
请求参数说明:
| 名称 |
必填 |
类型 |
说明 |
|
token
|
是
|
string
|
登录获取token
|
| id | 是 | string | 快递单号 |
| phone | 否 | string | 顺丰必传{手机号后4位} |
| 接口示例1 | 否 | string | https://apicx.asia/api/kuaidi?id=YT1234567890123&token=你的token (非顺丰查询) |
| 接口示例2 | 否 | string | https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token(顺丰查询) |
返回参数说明:
| 名称 |
类型 |
说明 |
| code |
integer |
返回的状态码 |
| data |
object |
返回的数据/数据对象 |
| msg |
string |
返回的消息 |
| time |
string |
请求时间 |
{
"code": 200,
"success": true,
"message": "成功",
"data": {
"express_info": {
"mailNo": "SF3196001295302",
"orderNo": "202510311519523183077",
"cpCode": "SF",
"logisticsCompanyName": "顺丰速运",
"logisticsStatus": "SIGN",
"logisticsStatusDesc": "已签收",
"theLastTime": "2025-07-17 18:17:47",
"theLastMessage": "经客户同意,快件已放在(前台),如有疑问请电联快递员【李光耀,电话:13138923207】。您的体验对于我们至关重要,如果您对我们的服务有任何的想法和建议,请随时联系我们,我们一定用心倾听,全力改进,不辜负您的信任与支持。"
},
"tracking_count": 20,
"latest_update": "顺丰速运 已收取快件,您的期待,我们定竭诚守护,不负所托。",
"full_tracking": [
{
"areaCode": "",
"areaName": "东莞市",
"subLogisticsStatus": "ACCEPT",
"timeDesc": "2025-07-12 21:18:28",
"time": 1752326308000,
"logisticsStatus": "ACCEPT",
"desc": "顺丰速运 已收取快件,您的期待,我们定竭诚守护,不负所托。"
},
{
"areaCode": "",
"areaName": "东莞市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 00:54:08",
"time": 1752339248000,
"logisticsStatus": "TRANSPORT",
"desc": "快件在【东莞虎门宴岗社区店】完成分拣,准备发往 【东莞陆运转运枢纽】"
},
{
"areaCode": "",
"areaName": "东莞市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 00:54:32",
"time": 1752339272000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开 【东莞虎门宴岗社区店】,已在发往 【东莞陆运转运枢纽】 的路上"
},
{
"areaCode": "",
"areaName": "东莞市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 02:06:10",
"time": 1752343570000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达 【东莞陆运转运枢纽】,该场地已实现光伏供电,低碳绿色物流、共建零碳未来!"
},
{
"areaCode": "",
"areaName": "东莞市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 02:18:11",
"time": 1752344291000,
"logisticsStatus": "TRANSPORT",
"desc": "快件在【东莞陆运转运枢纽】完成分拣,准备发往 【三亚凤凰转运站】"
},
{
"areaCode": "",
"areaName": "东莞市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 03:49:07",
"time": 1752349747000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开 【东莞陆运转运枢纽】,已在发往 【三亚凤凰转运站】 的路上"
},
{
"areaCode": "",
"areaName": "湛江市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 09:59:36",
"time": 1752371976000,
"logisticsStatus": "TRANSPORT",
"desc": "快件途经湛江市"
},
{
"areaCode": "",
"areaName": "海口市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 15:59:37",
"time": 1752393577000,
"logisticsStatus": "TRANSPORT",
"desc": "快件途经海口市"
},
{
"areaCode": "",
"areaName": "三亚市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-13 22:32:12",
"time": 1752417132000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达 【三亚凤凰转运站】"
},
{
"areaCode": "",
"areaName": "三亚市",
"subLogisticsStatus": "DELIVER_ABNORMAL",
"timeDesc": "2025-07-13 22:32:13",
"time": 1752417133000,
"logisticsStatus": "FAILED",
"desc": "由于地址不详,正在为您核实"
},
{
"areaCode": "",
"areaName": "三亚市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-14 05:43:46",
"time": 1752443026000,
"logisticsStatus": "TRANSPORT",
"desc": "快件在【三亚凤凰转运站】完成分拣,准备发往 【陵水椰林花园路西店】"
},
{
"areaCode": "",
"areaName": "三亚市",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-14 05:44:28",
"time": 1752443068000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开 【三亚凤凰转运站】,已在发往 【陵水椰林花园路西店】 的路上"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "ARRIVE_CITY",
"timeDesc": "2025-07-14 07:21:15",
"time": 1752448875000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达 【陵水椰林花园路西店,地址:陵水黎族自治县花园路西二横路49号】"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-14 09:29:33",
"time": 1752456573000,
"logisticsStatus": "TRANSPORT",
"desc": "快件在【陵水椰林花园路西店】完成分拣,准备发往 【三亚凤凰转运站】"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "TRANSPORT",
"timeDesc": "2025-07-14 11:20:50",
"time": 1752463250000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开 【陵水椰林花园路西店】,已在发往 【三亚凤凰转运站】 的路上"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "ARRIVE_CITY",
"timeDesc": "2025-07-17 16:18:50",
"time": 1752740330000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达 【陵水椰林新丰北路店,地址:陵水黎族自治县民族中学附近新党委隔壁十字路口左手侧面(老新丰北路90号老党校门口对面)】"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "DELIVERING",
"timeDesc": "2025-07-17 16:24:06",
"time": 1752740646000,
"logisticsStatus": "DELIVERING",
"desc": "我们正在为您的快件分配最合适的快递员,请您稍等。"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "DELIVERING",
"timeDesc": "2025-07-17 16:25:10",
"time": 1752740710000,
"logisticsStatus": "DELIVERING",
"desc": "快件交给【李光耀,联系电话:13138923207】,正在派送途中(如有任何问题可先联系我,我将尽全力为您解决。您的认可,是我最大的动力!)"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "STA_SIGN",
"timeDesc": "2025-07-17 16:30:54",
"time": 1752741054000,
"logisticsStatus": "SIGN",
"desc": "快件派送不成功(因电话无人接听/关机/无信号,暂无法联系到收方客户),正在处理中,待再次派送"
},
{
"areaCode": "",
"areaName": "陵水黎族自治县",
"subLogisticsStatus": "SIGN",
"timeDesc": "2025-07-17 18:17:47",
"time": 1752747467000,
"logisticsStatus": "SIGN",
"desc": "经客户同意,快件已放在(前台),如有疑问请电联快递员【李光耀,电话:13138923207】。您的体验对于我们至关重要,如果您对我们的服务有任何的想法和建议,请随时联系我们,我们一定用心倾听,全力改进,不辜负您的信任与支持。"
}
]
},
"timestamp": "2025-10-31 15:19:52",
"api_source": "API官网:http://apicx.asia",
"query_params": {
"express_id": "SF3196001295302",
"phone_provided": true,
"express_type": "顺丰快递"
},
"cached_time": "2025-10-31 15:19:52"
错误码格式说明:
| 名称 |
类型 |
说明 |
| 200 |
string |
返回状态码(成功) |
| 500 |
string |
返回的状态码(失败) |
代码示例:
-
-
-
-
-
-
-
<?php
// 初始化cURL会话
$ch = curl_init();
// 设置请求URL,用户中心获取token,自行替换其他参数
curl_setopt($ch, CURLOPT_URL, "https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token");
// 设置请求头
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Authorization: YOUR_TOKEN'
));
// 返回响应而不是直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// 执行请求并获取响应
$response = curl_exec($ch);
// 关闭cURL会话
curl_close($ch);
// 将响应解析为JSON格式
$data = json_decode($response, true);
// 输出JSON数据
print_r($data);
?>
import requests
# 设置请求URL和头部,用户中心获取token,自行替换其他参数
url = "https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token"
headers = {
'Authorization': 'YOUR_TOKEN'
}
# 发送GET请求
response = requests.get(url, headers=headers)
# 将响应解析为JSON格式
data = response.json()
# 输出JSON数据
print(data)
// 发送GET请求,用户中心获取token,自行替换其他参数
fetch("https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token", {
method: "GET",
headers: {
"Authorization": "YOUR_TOKEN"
}
})
.then(response => response.json()) // 将响应解析为JSON格式
.then(data => console.log(data)) // 输出JSON数据
.catch(error => console.error('Error:', error));
import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
public static void main(String[] args) throws Exception {
// 创建URL对象,用户中心获取token,自行替换其他参数
URL url = new URL("https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token");
// 打开连接
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
// 设置请求方法
conn.setRequestMethod("GET");
// 设置请求头
conn.setRequestProperty("Authorization", "YOUR_TOKEN");
// 读取响应
BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String inputLine;
StringBuffer content = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
content.append(inputLine);
}
in.close();
// 输出JSON数据
System.out.println(content.toString());
}
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main() {
using (HttpClient client = new HttpClient()) {
// 设置请求头
client.DefaultRequestHeaders.Add("Authorization", "YOUR_TOKEN");
// 发送GET请求,用户中心获取token,自行替换其他参数
HttpResponseMessage response = await client.GetAsync("https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token");
// 将响应解析为字符串
string responseBody = await response.Content.ReadAsStringAsync();
// 输出JSON数据
Console.WriteLine(responseBody);
}
}
}
require 'net/http'
require 'uri'
# 创建URI对象,用户中心获取token,自行替换其他参数
uri = URI.parse("https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token")
# 创建GET请求
request = Net::HTTP::Get.new(uri)
# 设置请求头
request["Authorization"] = "YOUR_TOKEN"
# 发送请求并获取响应
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request)
end
# 输出JSON数据
puts response.body
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
// 创建GET请求,用户中心获取token,自行替换其他参数
req, err := http.NewRequest("GET", "https://apicx.asia/api/kuaidi?id=SF3196001295302&phone=5957&token=你的token", nil)
if err != nil {
panic(err)
}
// 设置请求头
req.Header.Add("Authorization", "YOUR_TOKEN")
// 发送请求并获取响应
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
// 读取响应体
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
panic(err)
}
// 输出JSON数据
fmt.Println(string(body))
}