国际空运运价查询
按起运机场 + 目的机场查询国际空运运价。覆盖 1062 个国际机场，5 档分阶段重量报价（45/100/300/500/1000kg + MIN）。
接口信息
| 接口路径 | POST /api/openapi/v1/freight/air/search |
| 积分消耗 | 2 积分 / 次 |
| 数据更新 | 每日更新 |
请求参数
| 字段名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| pol | string | 是 | 起运机场，支持 3 位 IATA 代码（精确）/ 中文 / 英文（模糊）查代码 ↗ | PVG / 浦东 / Pudong |
| pod | string | 是 | 目的机场，支持 3 位 IATA 代码（精确）/ 中文 / 英文（模糊）查代码 ↗ | LAX / 洛杉矶 / Los Angeles |
| airline | string | 否 | 航司，支持 2 位 IATA 代码（精确）/ 中文 / 英文（模糊）查代码 ↗ | CA / 国航 / Air China |
| weight | number | 否 | 货物重量 kg（计费重，传入后自动匹配档位） | 220 |
| page | int | 否 | 页码，默认 1 | 1 |
| limit | int | 否 | 每页条数，默认 20，最大 50 | 20 |
| pol_country | string | 否 | 起运机场国家码（2 位 ISO，可选），pol 同名多机场时锁定国家 | CN |
| pod_country | string | 否 | 目的机场国家码（2 位 ISO，可选）。pod 同名多机场时不传则返回所有同名机场运价、按命中数计费；传此参数锁定单一国家 | US |
响应字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| resolved.pol / pod | object | 回显本次解析的机场（含 input/code/name/name_en） |
| list[].id | string | 运价记录唯一 ID |
| list[].pol / pod | object | 起运机场 / 目的机场 (code 为 IATA 3 位，含 name / name_en) |
| list[].airline | object | 航司 (code, name)，如 CA 中国国航 / PO 美国博立等 |
| list[].transit | object | { is_direct: 是否直飞, days: 飞行天数, port: 中转机场, route_path: 路径如 PVG-LAX } |
| list[].price_grades[] | array | 阶梯运价数组，每档 { min_weight, price_per_kg, currency }，一般有 45/100/300/500/1000 kg 档位 |
| list[].matched_grade | object | 入参 weight 命中的档位 { min_weight, price_per_kg, total: 单价×weight, currency }，请求带 weight 时才返回 |
| list[].schedule.cutoff | string | 周班期，1-7 表示周一到周日，逗号分隔（如 2,3,4,5,6,7 表示周二到周日有班） |
| list[].schedule.cutoff_remark | string | 班期备注（部分航司有特殊说明） |
| list[].valid_until | string | 运价有效期截止日 YYYY-MM-DD |
| list[].remark | string | 运价备注 |
| credit_used / credit_balance | int | 本次扣减积分（AIR 固定 2）/ 扣减后剩余 |
完整 curl 请求示例
# pol / pod 同时支持 IATA 3 位 / 中文 / 英文（如 "PVG" / "浦东" / "Pudong"）
curl -X POST https://www.5688.cn/api/openapi/v1/freight/air/search \
-H "Content-Type: application/json" \
-H "X-Awice-AppKey: AK_xxxxxxxxxxxxxxxx" \
-H "X-Awice-Timestamp: 1746086400" \
-H "X-Awice-Nonce: a1b2c3d4e5f6a7b8" \
-H "X-Awice-Signature: 7f8e9d6c5b4a..." \
-d '{
"pol": "PVG",
"pod": "LAX",
"airline": "CA",
"weight": 220,
"page": 1,
"limit": 20
}'成功响应示例
{
"code": 0,
"msg": "success",
"request_id": "req_xxxxxxxxxxxxxxxx",
"data": {
"resolved": {
"pol": { "input": "PVG", "code": "PVG", "name": "上海浦东国际机场", "name_en": "Shanghai Pudong International Airport" },
"pod": { "input": "LAX", "code": "LAX", "name": "洛杉矶国际机场", "name_en": "Los Angeles International Airport" },
"airline": null
},
"total": 15,
"page": 1,
"limit": 20,
"list": [
{
"id": "6346",
"pol": { "code": "PVG", "name": "上海浦东国际机场", "name_en": "Shanghai Pudong International Airport" },
"pod": { "code": "LAX", "name": "洛杉矶国际机场", "name_en": "Los Angeles International Airport" },
"airline": { "code": "PO", "name": "美国博立航空公司" },
"transit": {
"is_direct": true,
"days": 1,
"port": "",
"route_path": "PVG-LAX"
},
"price_grades": [
{ "min_weight": 100, "price_per_kg": 36, "currency": "USD" },
{ "min_weight": 300, "price_per_kg": 36, "currency": "USD" },
{ "min_weight": 500, "price_per_kg": 36, "currency": "USD" },
{ "min_weight": 1000, "price_per_kg": 33, "currency": "USD" }
],
"schedule": {
"cutoff": "2,3,4,5,6,7",
"cutoff_remark": ""
},
"valid_until": "2026-12-31",
"remark": "",
"matched_grade": {
"min_weight": 100,
"price_per_kg": 36,
"total": 3600,
"currency": "USD"
}
}
]
},
"credit_used": 2,
"credit_balance": 9496
}档位匹配规则：weight=220kg 落在 [100, 300) 区间 → 命中 100kg 档位的单价 ¥28；weight=35kg 落在 [0, 45) → 命中 MIN 档（固定 200，不乘 weight）。请求未传 weight 时不返回 matched_*。