Agent 发起请求
GET /api/ai-pay/flights?from=PEK&to=JFK&date=2026-06-01 不带任何 header。
把 FlyWise 200+ 条留学航线的实时价格开放给 AI Agent,一行请求就能查。走支付宝「智能收 (A2M)」协议结算,0.03 元/次,免 API Key、免注册。
GET /api/ai-pay/flights?from=PEK&to=JFK&date=2026-06-01 不带任何 header。
响应 header 带 Payment-Needed(含金额、商户单号、resource_id),Agent 调用支付宝智能收完成付款。
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": "..." }| 参数 | 必填 | 说明 |
|---|---|---|
from / origin | 是 | 出发机场 IATA 三字码(如 PEK)。多机场用逗号分隔(PEK,PVG) |
to / destination | 是 | 到达机场 IATA。多机场同上 |
date | 是 | 出发日期 YYYY-MM-DD |
max_results | 否 | 1–10,默认 3 |
cabin | 否 | economy / premium-economy / business(V1 仅记录,不参与爬取) |
| 字段 | 类型 | 说明 |
|---|---|---|
ok | boolean | true 表示有数据 |
flights | Flight[] | 航班列表,按价格升序 |
total_found | number | 实际抓到的总条数 |
source | string | scraper-fresh / scraper-cache / serpapi-fallback |
freshness | string | 「实时」/「N 分钟前」 |
trade_no | string | 支付宝侧的交易号,用于对账 |
detail_url | string | 对应人类可访问的 FlyWise 详情页 URL |
在对话里直接报价、付款、出结果,用户全程不跳出 Agent。
客服 bot 给学生 / 家长查最新机票价,不用自己接航司或聚合 API。
审批流里实时查价对比,价格回写到工单系统,按笔扣费易报销。
目前邀请制。发邮件或加微信,24 小时内回复,会给你一份《接入指南》和测试环境账号。