接口接入说明

这是使用 Apifox 原生在线文档和云端 Mock 的小型演示。所有请求、报价与航班信息均为虚构。

立即体验

在左侧打开「shopping 航班搜索接口」。

展开「调试」，选择「云端 Mock」。使用预填的标准 JSON，点击发送。

查看真实 HTTP 调用得到的响应。文档内的静态响应示例与实际调用结果是两个区域。

依次打开缺字段、错误类型、错误枚举、嵌套错误和约束错误接口并发送。它们的响应被故意设置为不符合统一 Schema。

使用供应商测试地址

在「shopping 航班搜索接口」调试中，切换至「供应商测试地址」，点击 baseUrl 变量填入供应商的测试服务地址。接口路径固定为 /shopping。填写不含末尾 /shopping 的服务根地址即可。

请求已经预设，不需要手动复制或粘贴 JSON。请使用专门的测试接口及虚构数据。

响应校验规则

所有接口共用同一份严格的 SearchResponse Schema，包含必填、类型、枚举、嵌套对象、数组数量、字符串长度、正则及数值范围。异常接口没有放宽 Schema。

演示	故意设置的问题
shopping 航班搜索接口	全部字段符合响应规范。
02 缺少必填字段	$.data.offers[0].offerId 缺失。
03 字段类型错误	$.data.offers[0].price 是字符串，应为 number；seats 是字符串，应为 integer。
04 枚举值错误	$.data.currency 为 EUR，不属于 SGD、USD、CNY。
05 嵌套结构错误	$.data.offers[0].segments[0].destination 缺失，origin 不符合三位大写代码。
06 基本约束错误	$.data.offers[0].price 为负数；seats 超过 9；offerId 少于 4 个字符。

本轮范围

本轮提供在线文档、标准请求、可切换的供应商地址和云端模拟响应。没有独立接收服务、入站请求记录和网页自动刷新结果。

2026-10-28 公开主站实测：使用预填 JSON 发送正常接口和「03 字段类型错误」接口，均获得 HTTP 200 并展示真实响应。错误接口的 price 和 seats 返回字符串，页面未显示自动字段校验错误，控制台也显示「没有内容」。因此本轮演示已验证在线文档和真实调试，未实现公开网页自动定位字段错误；上表是预期问题说明，不能代替自动校验结果。

使用 Apifox 官方域名即可体验本轮功能；未来可为此站绑定自己的域名。

发送前请求校验实测

公开文档调试中，将请求体改为 {} 后发送，得到 HTTP 200；缺少 requestId、tripType、passengers、journeys 没有被发送前拦截。错误 JSON 也曾被发出并由 Mock 服务返回 HTTP 400。另将已启用的前置脚本设为抛出明确错误，公开页仍发出请求并得到 HTTP 200；该临时脚本现已恢复。以上结果说明本轮公开页不能作为发送前 Schema 校验器。

Apifox 自定义 JavaScript 在默认 apifox.cn 域名下不执行。若未来确实需要发送前字段提示与阻止发送，需要另行评估自有域名扩展或独立校验组件；本轮不新增服务。

介绍

接口接入说明#

立即体验#

使用供应商测试地址#

响应校验规则#