尧图网站建设 
LetsFG PFS 航班搜索API完整指南Bearer Token 四步完成搜索、轮询与真实订座【免费下载链接】LetsFGAgent-native flight hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFGLetsFG 是一个面向 AI Agent 的航班与酒店搜索订座开源项目其 PFSProgrammatic Flight Search原始 API 让你仅凭一个 Bearer Token四步就能完成航班搜索、结果轮询和真实出票订座——搜索免费、无需本地浏览器、看到的是多少钱就付多少钱。PFS 原始API是什么为什么选它LetsFG 提供三条访问路径PFS 是其中最适合脚本和 Agent 的免费服务端通道通道鉴权方式搜索成本适合谁PFS 原始APIBearer Token卡片绑定免费脚本、AI AgentDeveloper APIX-API-Key预付费每次订座后 200 次免费超出按量计费高流量商业集成MCP 服务器托管token 自动携带免费Claude / Cursor / Windsurf 等PFS 的全部搜索都运行在官方服务端你不需要 Playwright、不需要自己爬航司网站。完整对比见 README.md 的 PFS 章节和 docs/getting-started.md。一键获取 Bearer Token连接无需卡片letsfg.co 网站本身对人类用户设有人机验证脚本无法直接访问因此Bearer Token 是唯一合法的编程入口。获取流程只需一次点击且不涉及任何扣款将 LetsFG 添加为 MCP 服务器或运行letsfg auth命令在打开的连接页面一次性授权——此时不需要卡片卡片只在第一次订座时才被要求0.00 元验证流程卡信息交给支付渠道不经过 LetsFG。Token 的存放与携带方式SDK 和 CLI 从环境变量LETSFG_BEARER_TOKEN或~/.letsfg/config.json读取裸 HTTP 请求则在每个请求头中携带Authorization: Bearer token。 限流规则每张卡片每 10 分钟 10 次、每小时 30 次、每天 100 次搜索轮询结果永远不计入额度。超限会返回 429 和retry_after_seconds请按提示等待。四步完整流程搜索 → 轮询 → 订座 → 出票以下四步对应原始 HTTP 端点与 MCP 工具search_flights/get_flight_results/book_flight/get_flight_booking一一对应。第一步POST /api/search 发起航班搜索请求体只需三要素出发地、目的地、日期支持自然语言查询。服务端立即返回search_idcurl -X POST https://letsfg.co/api/search \ -H Authorization: Bearer token \ -H Content-Type: application/json \ -d {origin:LHR,destination:BCN,date_from:2026-06-15} # → {search_id:ws_abc123,status:searching}首次结果通常在8–10 秒内到达。第二步GET /api/results/{search_id} 轮询搜索结果拿到search_id后立即轮询不要先睡眠再轮询之后每隔 2 秒一次curl https://letsfg.co/api/results/ws_abc123 \ -H Authorization: Bearer token两个关键细节搜索报告completed之后报价集合仍可能继续增长响应中的split_ticket_pending标记为 true 时要继续轮询否则你可能丢掉最便宜的行程搜索出的报价约15 分钟后过期订座请趁新鲜过期就重新搜索。第三步POST /api/agent-book 发起真实订座把search_id、选中的offer_id和旅客真实信息姓名须与护照一致、生日、国籍、电话、住址、联系邮箱一起提交数秒内返回booking_ref票价随即被**冻结hold**在卡片上curl -X POST https://letsfg.co/api/agent-book \ -H Authorization: Bearer token -H Content-Type: application/json \ -d {search_id:ws_abc123,offer_id:wo_abc123,contact_email:adaexample.com, passenger:{given_name:Ada,family_name:Lovelace,born_on:1990-04-01, gender:f,nationality:GB,phone_number:447700900000, phone_country:GB,address_line1:1 Analytical Way, address_city:London,address_postal:N1 9GU,address_country:GB}} # → {booking_ref:eyJ...,state:booking_in_progress}常见即时应答缺字段返回missing_detailsmissing_fields补上再调即可不扣款尚未绑卡返回payment_method_requiredadd_card_url。第四步POST /api/agent-book/status 轮询出票状态出票全程需要4–11 分钟每 20–30 秒轮询一次状态端点直到终态curl -X POST https://letsfg.co/api/agent-book/status \ -H Authorization: Bearer token -H Content-Type: application/json \ -d {booking_ref:eyJ...}state含义你该做什么booking_in_progress订座代理正在卖家结账页操作继续等待、继续轮询completed出票成功返回 PNR 与charged_amount把票号交给旅客failed未订成冻结金额已释放未扣任何款查看failure_reason可重新搜索needs_attentionLetsFG 人工正在处理切勿重复订座旅客会收到邮件资金安全设计先冻结出票后才扣款这是 PFS 最值得理解的安全机制订座开始时票价只是被冻结在卡片上不是划走LetsFG 订座代理替你在卖家处购买机票只有真实航司 PNR 存在时冻结才会转成扣款订座失败则释放分文不扣结账期间票价若变动你会收到price_change询问接受或放弃都由你决定绝不会静默扣款。原来的 unlock解锁报价步骤已于 2026-09-08 退役相关路由返回410 Gone——冻结-扣款机制让它彻底失去了存在必要。新手常见坑清单❌ 搜索后放着不订报价约 15 分钟过期请趁新鲜订座或重新搜索❌ 同一个行程同时发起两笔订座会形成第二笔卡片冻结进行中请只等结果❌ 轮询前加固定睡眠首次结果 8–10 秒就到应先轮询再等待❌ 用占位符旅客信息卖家结账页需要全部真实字段电子票会发到contact_email✅ 收到 429 时遵守retry_after_seconds反复超限会升级封禁10 分钟 → 6 小时 → 24 小时。延伸阅读完整 Agent 构建指南与最佳实践docs/agent-guide.md快速上手两条路径选型与首个搜索docs/getting-started.mdDeveloper API 订座全流程问题应答、中止订座、沙箱docs/api-booking.md异步搜索与轮询详解docs/api-polling.md航班搜索 Skill 定义skills/flight-search/SKILL.mdPython SDK 实现sdk/python/letsfg/【免费下载链接】LetsFGAgent-native flight hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFG创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 LetsFG PFS 航班搜索API完整指南：Bearer Token 四步完成搜索、轮询与真实订座
LetsFG PFS 航班搜索API完整指南Bearer Token 四步完成搜索、轮询与真实订座【免费下载链接】LetsFGAgent-native flight hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFGLetsFG 是一个面向 AI Agent 的航班与酒店搜索订座开源项目其 PFSProgrammatic Flight Search原始 API 让你仅凭一个 Bearer Token四步就能完成航班搜索、结果轮询和真实出票订座——搜索免费、无需本地浏览器、看到的是多少钱就付多少钱。PFS 原始API是什么为什么选它LetsFG 提供三条访问路径PFS 是其中最适合脚本和 Agent 的免费服务端通道通道鉴权方式搜索成本适合谁PFS 原始APIBearer Token卡片绑定免费脚本、AI AgentDeveloper APIX-API-Key预付费每次订座后 200 次免费超出按量计费高流量商业集成MCP 服务器托管token 自动携带免费Claude / Cursor / Windsurf 等PFS 的全部搜索都运行在官方服务端你不需要 Playwright、不需要自己爬航司网站。完整对比见 README.md 的 PFS 章节和 docs/getting-started.md。一键获取 Bearer Token连接无需卡片letsfg.co 网站本身对人类用户设有人机验证脚本无法直接访问因此Bearer Token 是唯一合法的编程入口。获取流程只需一次点击且不涉及任何扣款将 LetsFG 添加为 MCP 服务器或运行letsfg auth命令在打开的连接页面一次性授权——此时不需要卡片卡片只在第一次订座时才被要求0.00 元验证流程卡信息交给支付渠道不经过 LetsFG。Token 的存放与携带方式SDK 和 CLI 从环境变量LETSFG_BEARER_TOKEN或~/.letsfg/config.json读取裸 HTTP 请求则在每个请求头中携带Authorization: Bearer token。 限流规则每张卡片每 10 分钟 10 次、每小时 30 次、每天 100 次搜索轮询结果永远不计入额度。超限会返回 429 和retry_after_seconds请按提示等待。四步完整流程搜索 → 轮询 → 订座 → 出票以下四步对应原始 HTTP 端点与 MCP 工具search_flights/get_flight_results/book_flight/get_flight_booking一一对应。第一步POST /api/search 发起航班搜索请求体只需三要素出发地、目的地、日期支持自然语言查询。服务端立即返回search_idcurl -X POST https://letsfg.co/api/search \ -H Authorization: Bearer token \ -H Content-Type: application/json \ -d {origin:LHR,destination:BCN,date_from:2026-06-15} # → {search_id:ws_abc123,status:searching}首次结果通常在8–10 秒内到达。第二步GET /api/results/{search_id} 轮询搜索结果拿到search_id后立即轮询不要先睡眠再轮询之后每隔 2 秒一次curl https://letsfg.co/api/results/ws_abc123 \ -H Authorization: Bearer token两个关键细节搜索报告completed之后报价集合仍可能继续增长响应中的split_ticket_pending标记为 true 时要继续轮询否则你可能丢掉最便宜的行程搜索出的报价约15 分钟后过期订座请趁新鲜过期就重新搜索。第三步POST /api/agent-book 发起真实订座把search_id、选中的offer_id和旅客真实信息姓名须与护照一致、生日、国籍、电话、住址、联系邮箱一起提交数秒内返回booking_ref票价随即被**冻结hold**在卡片上curl -X POST https://letsfg.co/api/agent-book \ -H Authorization: Bearer token -H Content-Type: application/json \ -d {search_id:ws_abc123,offer_id:wo_abc123,contact_email:adaexample.com, passenger:{given_name:Ada,family_name:Lovelace,born_on:1990-04-01, gender:f,nationality:GB,phone_number:447700900000, phone_country:GB,address_line1:1 Analytical Way, address_city:London,address_postal:N1 9GU,address_country:GB}} # → {booking_ref:eyJ...,state:booking_in_progress}常见即时应答缺字段返回missing_detailsmissing_fields补上再调即可不扣款尚未绑卡返回payment_method_requiredadd_card_url。第四步POST /api/agent-book/status 轮询出票状态出票全程需要4–11 分钟每 20–30 秒轮询一次状态端点直到终态curl -X POST https://letsfg.co/api/agent-book/status \ -H Authorization: Bearer token -H Content-Type: application/json \ -d {booking_ref:eyJ...}state含义你该做什么booking_in_progress订座代理正在卖家结账页操作继续等待、继续轮询completed出票成功返回 PNR 与charged_amount把票号交给旅客failed未订成冻结金额已释放未扣任何款查看failure_reason可重新搜索needs_attentionLetsFG 人工正在处理切勿重复订座旅客会收到邮件资金安全设计先冻结出票后才扣款这是 PFS 最值得理解的安全机制订座开始时票价只是被冻结在卡片上不是划走LetsFG 订座代理替你在卖家处购买机票只有真实航司 PNR 存在时冻结才会转成扣款订座失败则释放分文不扣结账期间票价若变动你会收到price_change询问接受或放弃都由你决定绝不会静默扣款。原来的 unlock解锁报价步骤已于 2026-09-08 退役相关路由返回410 Gone——冻结-扣款机制让它彻底失去了存在必要。新手常见坑清单❌ 搜索后放着不订报价约 15 分钟过期请趁新鲜订座或重新搜索❌ 同一个行程同时发起两笔订座会形成第二笔卡片冻结进行中请只等结果❌ 轮询前加固定睡眠首次结果 8–10 秒就到应先轮询再等待❌ 用占位符旅客信息卖家结账页需要全部真实字段电子票会发到contact_email✅ 收到 429 时遵守retry_after_seconds反复超限会升级封禁10 分钟 → 6 小时 → 24 小时。延伸阅读完整 Agent 构建指南与最佳实践docs/agent-guide.md快速上手两条路径选型与首个搜索docs/getting-started.mdDeveloper API 订座全流程问题应答、中止订座、沙箱docs/api-booking.md异步搜索与轮询详解docs/api-polling.md航班搜索 Skill 定义skills/flight-search/SKILL.mdPython SDK 实现sdk/python/letsfg/【免费下载链接】LetsFGAgent-native flight hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFG创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考