邮政快递查询,支持邮件号、高考号、苹果件,返回物流轨迹与状态。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| num | string | 是 | 支持邮件号,高考号,苹果件 | |
| phone | string | 否 | 发件人|收件人 手机尾号,一般为后4位 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "num",
"type": "string",
"required": true,
"description": "支持邮件号,高考号,苹果件",
"example": ""
},
{
"name": "phone",
"type": "string",
"required": false,
"description": "发件人|收件人 手机尾号,一般为后4位",
"example": ""
}
]
{
"openapi": "3.1.1",
"info": {
"title": "邮政快递",
"description": "邮政快递查询,支持邮件号、高考号、苹果件,返回物流轨迹与状态。",
"version": "1.0.0"
},
"paths": {
"\/api\/express\/ems\/index.php": {
"get": {
"summary": "邮政快递",
"description": "邮政快递查询,支持邮件号、高考号、苹果件,返回物流轨迹与状态。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "num",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "支持邮件号,高考号,苹果件"
},
{
"name": "phone",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "发件人|收件人 手机尾号,一般为后4位"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "邮政快递",
"description": "邮政快递查询,支持邮件号、高考号、苹果件,返回物流轨迹与状态。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "num",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "支持邮件号,高考号,苹果件"
},
{
"name": "phone",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "发件人|收件人 手机尾号,一般为后4位"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https:\/\/api.vsaa.cn",
"description": "当前访问入口(https)"
}
]
}
{
"success": true,
"code": "000000",
"message": "SUCCESS",
"data": {
"mailNo": "9821266921355",
"isLogin": 0,
"state": "18",
"stateText": "已签收(本人收)",
"traces": [
{
"time": "2026-01-17 10:23:36",
"operationCode": "702",
"desc": "派送中",
"state": "11",
"stateText": "派送中"
},
{
"time": "2026-01-17 12:07:01",
"operationCode": "747",
"desc": "待取件",
"state": "13",
"stateText": "待取件"
},
{
"time": "2026-01-21 15:50:24",
"operationCode": "748",
"desc": "本人收",
"state": "18",
"stateText": "已签收(本人收)"
}
],
"info": {
"mail": {
"admissionLetter": 0,
"approvalContent": null,
"backDeliverer": null,
"backFlag": 0,
"baseProductName": "国内快递包裹",
"baseProductNo": "11312",
"bizProductName": "快递包裹",
"bizProductNo": "113124300000691",
"codFlag": 0,
"collector": {
"code": "01872657",
"id": "",
"name": "冯锦业",
"opTime": "2026-01-13 17:00:29",
"orgCode": "52841524",
"orgName": "中山市电商客户小榄大宗揽收部",
"phone": "13824781762",
"rate": 4,
"star": "4"
},
"dateDiff": "7天22小时",
"deliverDesc": "",
"deliverState": "",
"deliverer": {
"code": "6352001019940",
"id": "",
"name": "熊磊",
"opTime": "2026-01-17 10:23:36",
"orgCode": "63520010",
"orgName": "渠县城东揽投部",
"phone": "18881885803",
"rate": 4,
"star": "4"
},
"distributeFlag": true,
"evaluatedCourierType": 0,
"forwardWaybillNo": "",
"gaokaoFlag": false,
"international": 0,
"lastMailInfo": {
"acceptAddress": "",
"arrivalCity": "",
"backFlag": 0,
"cityLat": "30.8594440",
"cityLng": "106.9591750",
"deliverState": "",
"deliveryStateName": "",
"forwardWaybillNo": "",
"isGuangFu": "0",
"logo": "邮政",
"mailState": "18",
"mailStateDesc": "本人收",
"mailStateSign": "d6NTwqhOSYHZaVJ13zfSnA==",
"notes": "收件人已取走邮件",
"operation": "您的快件已取走【望江亭3号楼妈妈驿站】,如有疑问请电联快递员【电话:18881885803】,投诉电话【电话:0818-7322303】。有事呼叫我,少一次投诉,多一份感恩。中国邮政将全心呵护您的所托,服务热线11183。",
"operationCode": "748",
"operationLimit": "",
"operatorCode": "6352001019940",
"operatorName": "自提点",
"operatorPhone": "",
"orgCode": "63520010",
"orgLat": "",
"orgLng": "",
"orgName": "渠县城东揽投部",
"productName": "快递包裹",
"promisedArrivalTime": "",
"receiverCity": "",
"returnOrRevokeState": "",
"secondMailInfos": [],
"secondMailNo": "",
"secondMailType": null,
"senderCity": "",
"state": 0,
"stateDesc": "本人收",
"time": "2026-01-21 15:50:24",
"timeLimit": "",
"transportType": "1",
"mailStateText": "已签收(本人收)"
},
"logo": "邮政",
"mailInfoCount": 16,
"mailInfos": [
{
"acceptAddress": "",
"arrivalCity": "",
"backFlag": 0,
"cityLat": "30.8594440",
"cityLng": "106.9591750",
"deliverState": "",
"deliveryStateName": "",
"forwardWaybillNo": "",
"isGuangFu": "0",
"logo": "邮政",
"mailState": "11",
"mailStateDesc": "派送中",
"mailStateSign": "DmqujS3Xc0Mgq0JszcMY5A==",
"notes": "",
"operation": "快件正在派送中,请耐心等待,保持电话畅通,准备签收,如有疑问请电联快递员【熊磊,电话:18881885803】或揽投部【电话:0818-7322303】,服务热线11183。",
"operationCode": "702",
"operationLimit": "",
"operatorCode": "6352001019940",
"operatorName": "熊磊",
"operatorPhone": "18881885803",
"orgCode": "63520010",
"orgLat": "",
"orgLng": "",
"orgName": "渠县城东揽投部",
"productName": "快递包裹",
"promisedArrivalTime": "",
"receiverCity": "",
"returnOrRevokeState": "",
"secondMailInfos": [],
"secondMailNo": "",
"secondMailType": null,
"senderCity": "",
"state": 0,
"stateDesc": "派送中",
"time": "2026-01-17 10:23:36",
"timeLimit": "",
"transportType": "1",
"mailStateText": "派送中"
},
{
"acceptAddress": "",
"arrivalCity": "",
"backFlag": 0,
"cityLat": "30.8594440",
"cityLng": "106.9591750",
"deliverState": "",
"deliveryStateName": "",
"forwardWaybillNo": "",
"isGuangFu": "0",
"logo": "邮政",
"mailState": "13",
"mailStateDesc": "待取件",
"mailStateSign": "M3lpax0Avq7UXoOVsPSVpQ==",
"notes": "望江亭3号楼妈妈驿站买菜代收点已接收;自提点联系方式:13566025987",
"operation": "您的快件已派送至【望江亭3号楼妈妈驿站】,自提点电话:13566025987,请您凭取件码领取快件,如有疑问请电联快递员【电话:18881885803】,投诉电话(电话0818-7322303)。有事呼叫我,少一次投诉,多一份感恩。中国邮政将全心呵护您的所托,服务热线11183。",
"operationCode": "747",
"operationLimit": "",
"operatorCode": "6352001019940",
"operatorName": "熊磊",
"operatorPhone": "18881885803",
"orgCode": "63520010",
"orgLat": "",
"orgLng": "",
"orgName": "渠县城东揽投部",
"productName": "快递包裹",
"promisedArrivalTime": "",
"receiverCity": "",
"returnOrRevokeState": "",
"secondMailInfos": [],
"secondMailNo": "",
"secondMailType": 0,
"senderCity": "",
"state": 0,
"stateDesc": "待取件",
"time": "2026-01-17 12:07:01",
"timeLimit": "",
"transportType": "1",
"mailStateText": "待取件"
},
{
"acceptAddress": "",
"arrivalCity": "",
"backFlag": 0,
"cityLat": "30.8594440",
"cityLng": "106.9591750",
"deliverState": "",
"deliveryStateName": "",
"forwardWaybillNo": "",
"isGuangFu": "0",
"logo": "邮政",
"mailState": "18",
"mailStateDesc": "本人收",
"mailStateSign": "d6NTwqhOSYHZaVJ13zfSnA==",
"notes": "收件人已取走邮件",
"operation": "您的快件已取走【望江亭3号楼妈妈驿站】,如有疑问请电联快递员【电话:18881885803】,投诉电话【电话:0818-7322303】。有事呼叫我,少一次投诉,多一份感恩。中国邮政将全心呵护您的所托,服务热线11183。",
"operationCode": "748",
"operationLimit": "",
"operatorCode": "6352001019940",
"operatorName": "自提点",
"operatorPhone": "",
"orgCode": "63520010",
"orgLat": "",
"orgLng": "",
"orgName": "渠县城东揽投部",
"productName": "快递包裹",
"promisedArrivalTime": "",
"receiverCity": "",
"returnOrRevokeState": "",
"secondMailInfos": [],
"secondMailNo": "",
"secondMailType": null,
"senderCity": "",
"state": 0,
"stateDesc": "本人收",
"time": "2026-01-21 15:50:24",
"timeLimit": "",
"transportType": "1",
"mailStateText": "已签收(本人收)"
}
],
"mailNo": "9821266921355",
"mailState": "18",
"mailStateDesc": "本人收",
"mailStateSign": "d6NTwqhOSYHZaVJ13zfSnA==",
"mapType": 0,
"mmtdFlag": 0,
"oneBillFlag": 0,
"orderId": "",
"originAddressCity": "",
"originAddressLat": "",
"originAddressLng": "",
"originAddressType": 0,
"passwordDelivery": 0,
"postageRealPaid": "",
"postingInfo": "",
"productName": "快递包裹",
"receiptFlag": 0,
"receiverArea": "",
"receiverAreaCode": "511725",
"receiverCity": "***",
"receiverCityCode": "511700",
"receiverCityLat": "30.840251",
"receiverCityLng": "106.982382",
"receiverCountryName": "中华人民共和国",
"receiverProvince": "",
"receiverProvinceCode": "510000",
"relation": 0,
"returnOrRevokeState": "",
"senderArea": "",
"senderAreaCode": "442000",
"senderCity": "***",
"senderCityCode": "442000",
"senderCityLat": "22.706477",
"senderCityLng": "113.27812",
"senderProvince": "",
"senderProvinceCode": "440000",
"senderType": "1",
"state": 0,
"stateDesc": "本人收",
"updateFlag": 0,
"userSign": "",
"mailStateText": "已签收(本人收)"
},
"distance": {
"length": "3079.6",
"level": "14",
"area": 3
},
"gis": {
"activeTraces": null,
"dottedTraces": null,
"sleeklyTraces": null
},
"personalizedData": {
"courierImgUrl": "",
"courierJumpParameter": null,
"courierType": 0,
"isCourierSupportJump": 0,
"isSceneSupportJump": 0,
"isVehicleSupportJump": 0,
"sceneImgUrl": "",
"sceneJumpParameter": null,
"sceneType": 0,
"vehicleImgUrl": "",
"vehicleJumpParameter": null,
"vehicleType": 0
},
"openId": "",
"isLogin": 0
}
},
"debug": {
"attempts": 1,
"http_code": 200
}
}
暂无详细文档
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
欢迎使用 万象数据API(以下简称“本平台”,域名为 api.vsaa.cn)。在使用本平台提供的任何接口、数据及相关服务之前,请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用,均视为您已阅读、理解并同意本声明的全部条款。
最后更新日期:2026年10月6日