OpenAPI 参数序列化实验室

根据 style 和 explode 设置,在本地预览 OpenAPI 路径、查询、请求头和 Cookie 参数的序列化结果。

输入只在当前页面处理,不上传、不保存。

载入 OpenAPI 规范并选择接口,预览参数如何组成请求目标、请求头和 Cookie。工具不会发送请求。

在下方粘贴 JSON 或 YAML,也可以选择文件。

最多支持 2 MB、300 个路径操作。支持 OpenAPI 3.0、3.1 和 3.2;不会获取外部引用。

此工具会序列化哪些内容?

它根据 OpenAPI 的 style 和 explode 设置处理路径、查询、请求头和 Cookie 参数。支持常见的 simple、label、matrix、form、spaceDelimited、pipeDelimited 和 deepObject。

哪些内容需要人工复核?

工具不会猜测基于 content 的参数、嵌套数组或对象、未定义的样式组合和外部引用。请求头值不会进行 URI 编码,因为引号和转义规则取决于具体请求头。工具不校验 Schema。

工具会调用 API 吗?

不会。工具只为所选接口生成本地预览,不会解析服务器地址、添加认证信息或发送网络请求。

核对 API 参数在线上传输时的表示

粘贴或选择 OpenAPI 3.0、3.1 或 3.2 规范,检查后选择路径操作,并调整各参数的 JSON 值。预览路径、查询字符串、请求头和 Cookie,再复制需要的部分。

实际例子与结果

例如 GET /users/{id} 的查询数组 `tag: [api, local]` 使用 `style: form` 和 `explode: true` 时会变成 `tag=api&tag=local`。路径中的标量值会先编码再替换模板。本工具不校验 Schema,也不会发送请求;content 编码、嵌套值和外部引用等情况会留给人工复核。