1. 指南
iWofly OpenAPI
  • SUPPLIER_API_V1.0
    • 指南
      • API调用流程
      • 介绍
      • 附录
      • 版本历史
      • 错误码
    • API 参考
      • 联调示例
        • 02 缺少必填字段
        • 03 字段类型错误
        • 04 枚举值错误
        • 05 嵌套结构错误
        • 06 基本约束错误
      • shopping 航班搜索接口
    • 关于我们
      • 接入说明
  1. 指南

API调用流程

航班搜索联调流程#

在浏览器中使用预填请求发起真实 HTTP 调用。先体验云端 Mock,再切换供应商自己的测试地址。所有示例均为虚构数据。

开始联调#

步骤操作
1阅读「介绍」和「附录」,了解字段规范。
2打开「API 参考 → 航班搜索接口」,点击「调试」。
3选择「云端 Mock」,使用预填 JSON 点击发送。
4切换「供应商测试地址」,填写 baseUrl 后调用自己的测试服务。
5在「联调示例」中对比缺字段、类型、枚举、嵌套和约束错误。

响应校验(自定义扩展)#

请通过 https://flight-apidoc.iwofly.cn 访问文档,点击右下角的 「响应校验」。
1.
选择「Apifox 云端 Mock」和示例场景,点击 「发送并校验」。标准 JSON 已预填,无需复制或粘贴。
2.
查看 HTTP 状态、原始响应、校验结论,以及具体字段错误。例如缺字段场景会定位到 $.data.offers[0].offerId。
3.
点击 「运行全部 Mock」,依次测试正常、缺字段、类型、枚举、嵌套和约束错误;可点击结果记录查看对应报文。
4.
选择「供应商测试地址」后可填写完整的 HTTPS 测试接口地址。当前使用同一份标准请求执行 POST,预期响应为 HTTP 200 和 JSON;测试接口需要允许来自本文档域名的浏览器跨域请求。

原生调试与扩展范围#

Apifox 原生「调试 → 发送」仍用于请求调试和响应展示;本扩展不会接管它的发送按钮,也不提供原生发送前的 Schema 拦截。请使用扩展面板中的「发送并校验」获取自动校验结果。
扩展依据当前项目导出的 OpenAPI 快照检查 HTTP 状态码、Content-Type 与响应 JSON。原始响应保持只读;可读取的 Header 受浏览器 CORS 规则限制。结果仅保存在当前页面内存,刷新后清空。
自定义 JavaScript 仅在绑定后的自定义域名生效,默认 apifox.cn 地址不会加载本扩展。本 Demo 尚未提供独立的供应商入站请求接收服务。
修改于 2026-10-29 03:56:46
下一页
介绍
Built with