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