•VOLO Engineering
从 API 到预订：集成 VOLO Agent API 的开发者指南
private aviation APIagent API integrationdeveloper tutorialREST APIGraphQL
如果您正在构建处理旅行、高管服务或奢华生活方式管理的 AI Agent，与 VOLO 集成可让您的 Agent 访问全球 500+ 架私人飞机——并能在每次预订中赚取佣金。以下是入门指南。
第一步：注册您的 Agent
注册只需一次 API 调用：
POST https://flyvolo.ai/api/v1/agent/register
发送包含 Agent 名称、联系邮箱和可选 Webhook URL 的 JSON 正文。您将收到：
- 唯一的 Agent ID（如
AGT-TRAVELBOT-2A3F） - 用于认证请求的 API 密钥
- 用于跟踪归因的推荐码
- 用于分享的推荐 URL
第二步：搜索航班
VOLO 的搜索端点接受自然语言查询：
POST https://flyvolo.ai/api/v1/flights/search
您的 Agent 可以发送诸如"重型飞机，8 位乘客，纽约到伦敦，3 月 20 日"的查询，并接收包含飞机选项、规格、定价和可用时间窗口的结构化 JSON 响应。
第三步：生成报价
用户选择飞机选项后，生成详细的全包报价。响应包括逐项费用（包机、燃油、着陆费、机组、餐饮）和预订确认链接。
第四步：跟踪推荐
通过您的推荐链接或 API 密钥进行的每次预订都自动归属于您的 Agent。通过仪表板端点监控您的表现：
GET https://flyvolo.ai/api/v1/agent/dashboard
仪表板返回实时指标，包括总推荐数、转化率、待结算佣金和历史收入。
集成协议
选择最适合您 Agent 架构的集成方式：
| 协议 | 最适用于 | 特点 |
|---|---|---|
| REST API | 通用 | 标准 HTTP，JSON 响应，完整功能集 |
| GraphQL | 复杂查询 | 灵活数据获取，单端点，类型化 schema |
| OpenAI 插件 | ChatGPT/GPT 代理 | 自然语言界面，自动工具选择 |
| MCP 服务器 | Claude 代理 | 原生 Claude 集成，无状态工具，本地执行 |
佣金结构
作为注册的 Agent 合作伙伴，您在每次完成的预订中赚取佣金：
- 标准层：3.0% 佣金（0+ 订单）
- 白银层：3.5% 佣金（10+ 订单）
- 黄金层：4.0% 佣金（50+ 订单）
- 铂金层：5.0% 佣金（200+ 订单）
以平均 5 万美元的预订计算，每次成功推荐可获得 1,500-2,500 美元。佣金在航班完成后按月结算。
获取帮助
我们的开发者文档可在 flyvolo.ai/api/v1/openapi.json（OpenAPI 3.0 规范）获取。如需技术支持，请联系工程团队。我们正在一起构建 Agent 经济。
最好的 Agent 将是那些能够处理用户全方位需求的——从日程安排到预订到旅行。VOLO 的 API 让私人航空只需一次简单的集成。