● FOR DEVELOPERS · 开发者接入

给 AI Agent 用的
航班价格 API。

把 FlyWise 200+ 条留学航线的实时价格开放给 AI Agent,一行请求就能查。走支付宝「智能收 (A2M)」协议结算,0.03 元/次,免 API Key、免注册。

Pay-as-you-go
¥0.03元 / 次
含税,按支付宝智能收费率结算
  • 30 分钟新鲜度命中缓存秒返回,未命中走 Camoufox 实时抓 Google Flights。
  • 200+ 留学航线PVG / PEK / CAN / HKG 出发,覆盖北美、欧洲、大洋洲、东亚 45+ 城市。
  • 多机场一次扣费一次请求查多个出发/到达机场(如 PEK,PVG → JFK,EWR),仍按 1 次 0.03 元结算。
  • 标准 HTTP 402Agent 自带支付宝智能收插件即可走完支付、验证、履约全流程,零集成成本。

三步走,全自动/ Agent 直接对话支付宝,我们不发 Key

1

Agent 发起请求

GET /api/ai-pay/flights?from=PEK&to=JFK&date=2026-06-01 不带任何 header。

2

服务端返 402 + 收款单

响应 header 带 Payment-Needed(含金额、商户单号、resource_id),Agent 调用支付宝智能收完成付款。

3

携带凭证重试

Agent 把 Payment-Proof 放回 header 重试同一个 URL,服务端 verify 通过后返回 200 + 航班 JSON + Payment-Validation header。

接口示例/ 选你顺手的语言

示例只展示「带凭证查询」一步;首次 402 询价、支付、retry 由你的 Agent 框架(如 Anthropic skill 或 OpenAI tool)自动处理。

# 1) 第一次请求(不带凭证)—— 服务端会返回 402 + Payment-Needed header
curl -i 'https://flywise.win/api/ai-pay/flights?from=PEK&to=JFK&date=2026-06-01&max_results=3'
# HTTP/1.1 402 Payment Required
# Payment-Needed: <base64url(JSON{...0.03 元收款单...})>

# 2) Agent 用支付宝智能收完成付款,拿到 Payment-Proof
# 3) 携带凭证重试同一个 URL
curl 'https://flywise.win/api/ai-pay/flights?from=PEK&to=JFK&date=2026-06-01&max_results=3' \
  -H 'Payment-Proof: <base64url(JSON{ protocol: { payment_proof, trade_no } })>'
# HTTP/1.1 200 OK
# { "ok": true, "flights": [...], "trade_no": "..." }

请求 & 响应字段/ 完整 schema 见接入文档

请求参数(query string)

参数必填说明
from / origin出发机场 IATA 三字码(如 PEK)。多机场用逗号分隔(PEK,PVG)
to / destination到达机场 IATA。多机场同上
date出发日期 YYYY-MM-DD
max_results1–10,默认 3
cabineconomy / premium-economy / business(V1 仅记录,不参与爬取)

响应字段(200 OK)

字段类型说明
okbooleantrue 表示有数据
flightsFlight[]航班列表,按价格升序
total_foundnumber实际抓到的总条数
sourcestringscraper-fresh / scraper-cache / serpapi-fallback
freshnessstring「实时」/「N 分钟前」
trade_nostring支付宝侧的交易号,用于对账
detail_urlstring对应人类可访问的 FlyWise 详情页 URL

谁在用/ 适合这些场景

AI 出行助手

在对话里直接报价、付款、出结果,用户全程不跳出 Agent。

留学 / 移民咨询

客服 bot 给学生 / 家长查最新机票价,不用自己接航司或聚合 API。

差旅审批工具

审批流里实时查价对比,价格回写到工单系统,按笔扣费易报销。

想接入?

目前邀请制。发邮件或加微信,24 小时内回复,会给你一份《接入指南》和测试环境账号。

邮箱yuqiu011@gmail.com
微信加好友请备注「FlyWise API」
发邮件申请 返回首页