快递查询

快递查询 GET 频率：60次/每分钟

https://api.71ywl.com/api/index.php?qy=kuaiok

接口描述

提供包括100+快递在内的快递物流单号查询版

请求参数

参数名	类型	必填	示例	说明
ckey	string	是	SJKHJDBBDGGE	后台KEY
trackingNo	string	是	YT1234567890123	运单号

请求示例

https://api.71ywl.com/api/index.php?qy=kuaiok?trackingNo=YT1234567890123

响应示例

{
  "code": "0000000000",
  "desc": "OK",
  "data": {
    "serviceCode": 0,
    "packageInfoList": [
      {
        "sendCode": "",
        "trackingNo": "YT1234567890123",
        "cp": "YTO",
        "cpName": "圆通速递",
        "state": "FINISH",
        "signFlag": "AUTOMATIC",
        "operateMessage": "您的快件已投递，收件人: 门口。如有疑问请联系快递员: 18126827231，网点电话：02089448690，投诉电话: 020-89205442。(有事先呼我，勿找平台，少一次投诉，多一份感恩）！感谢使用圆通速递，期待再次为您服务！",
        "operateTime": "20260106154333",
        "trackingDetails": [
          {
            "time": "20260106154333",
            "context": "您的快件已投递，收件人: 门口。如有疑问请联系快递员: 18126827231，网点电话：02089448690，投诉电话: 020-89205442。(有事先呼我，勿找平台，少一次投诉，多一份感恩）！感谢使用圆通速递，期待再次为您服务！",
            "state": "FINISH"
          },
          {
            "time": "20260105145202",
            "context": "您的快件已到达[妈妈驿站]保利百合花园一期问梅街街10号，请您及时取件，如有取件码问题或找不到包裹等问题，请联系站点：18126827231，快递员电话：18126827231，投诉电话：020-89205442。感谢使用圆通速递，期待再次为您服务！"
          },
          {
            "time": "20260105145102",
            "context": "【广东省广州市海珠区工业大道】的陈汉军（18126827231）正在派件，（有事先呼我，勿找平台，少一次投诉，多一份感恩）！如有疑问请联系网点:02089448690，投诉电话:020-89205442。[95161和18521号段的上海号码为圆通快递员专属号码，请放心接听]"
          }
        ],
        "isTracking": 0,
        "getcode": "",
        "address": "",
        "onboxTime": "",
        "cabinetLocation": {
          "locationSystem": "GCJ02",
          "latitude": "",
          "longitude": ""
        },
        "trackingFlag": 2,
        "cpLinkList": []
      }
    ],
    "productRecommend": [],
    "stateStatList": [
      {
        "state": "FINISH",
        "total": 1
      }
    ]
  }
}

返回参数

参数名	类型	说明
code	string	响应状态码，例如
desc	string	响应描述，例如
data	object	响应数据对象
data.serviceCode	number	服务代码，0表示成功
data.packageInfoList	array	快递包裹信息列表
data.packageInfoList[].sendCode	string	发送码，可能为空
data.packageInfoList[].trackingNo	string	快递运单号
data.packageInfoList[].cp	string	快递公司编码，例如
data.packageInfoList[].cpName	string	快递公司名称
data.packageInfoList[].state	string	包裹状态，例如
data.packageInfoList[].signFlag	string	签收标志，例如
data.packageInfoList[].operateMessage	string	最新操作信息
data.packageInfoList[].operateTime	string	最新操作时间，格式YYYYMMDDHHMMSS
data.packageInfoList[].trackingDetails	array	物流跟踪详情列表
data.packageInfoList[].trackingDetails[].time	string	跟踪时间
data.packageInfoList[].trackingDetails[].context	string	跟踪内容描述
data.packageInfoList[].trackingDetails[].state	string	（可选）该条跟踪的状态
data.packageInfoList[].isTracking	number	是否跟踪中，0表示否
data.packageInfoList[].getcode	string	取件码，可能为空
data.packageInfoList[].address	string	地址信息，可能为空
data.packageInfoList[].onboxTime	string	入柜时间，可能为空
data.packageInfoList[].cabinetLocation	object	柜子位置信息
data.packageInfoList[].cabinetLocation.locationSystem	string	坐标系，例如
data.packageInfoList[].cabinetLocation.latitude	string	纬度，可能为空
data.packageInfoList[].cabinetLocation.longitude	string	经度，可能为空
data.packageInfoList[].trackingFlag	number	跟踪标志，例如2表示可能已完成
data.packageInfoList[].cpLinkList	array	快递公司链接列表，可能为空
data.productRecommend	array	产品推荐列表，可能为空
data.stateStatList	array	状态统计列表
data.stateStatList[].state	string	状态名称
data.stateStatList[].total	number	该状态下的包裹数量

响应码

状态码	说明
200	请求成功
203	秘钥错误或不存在
204	服务器错误
211	接口不存在
212	当前接口已下架
213	当前接口正处于审核期
214	API本地文件不存在，请联系管理员检查
215	管理员设置当前接口必须携带ckey请求！
216	付费接口请携带ckey请求！
217	ckey不存在！
218	当前ckey无权限调用此接口，请将此接口添加到ckey调用能力中后重试！
219	访问频率超过限制！请稍后重试！
220	本地API逻辑错误！请联系管理员检查！
221	状态码与管理员配置的状态码不一致，请联系管理员！
222	禁止访问！请联系管理员 (已被加入黑名单)
223	积分不足！请充值后重试
224	余额不足！请充值后重试
225	您已设置仅白名单ip访问！请将当前ip添加到白名单中

代码示例

curl

curl -X GET "https://api.71ywl.com/api/index.php?qy=kuaiok?trackingNo=xxx"

php

<?php
$url = "https://api.71ywl.com/api/index.php?qy=kuaiok?trackingNo=xxx";
$response = file_get_contents($url);
echo $response;
?>

python

import requests

url = "https://api.71ywl.com/api/index.php?qy=kuaiok?trackingNo=xxx"
response = requests.get(url)
print(response.json())

javascript

fetch("https://api.71ywl.com/api/index.php?qy=kuaiok?trackingNo=xxx")
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));