https://api.example.com/users?page=1&limit=10https://api.example.com/users?availableavailable 可以作为一个没有值的参数。当值为空时,Apifox 会自动省略键和值之间的等号。
{} 包裹。示例:https://api.example.com/pet/{petId}{参数名},Apifox 就会自动识别,并在下方自动显示对应的参数输入框。{} 占位符格式,变量只写在 Path 参数的 “参数值” 中。/pet/{petId}petId,在 “参数值” 里使用双大括号 {{}} 填入变量名,例如 {{petId}}。这样就相当于在 URL 路径里使用变量了。{{}}会影响 Apifox 的 Mock API 功能的使用。另外,这种写法不符合 OAS 规范,无法在 OpenAPI 生态的工具中正常集成。因此,不推荐在 URL 上直接写变量,例如 /pet/{{petId}}{parameter} vs {{variable}}{parameter} (Path 参数)/pet/{petId})。它告诉系统 “这里有一个参数”,需要单独定义类型和说明。{{variable}} (变量引用)EncodeURIComponent 编码或 DecodeURIComponent 解码,也可以将其存入变量。
form-data 是一种发送键值对的方式,类似于提交 HTML 表单。这种格式特别适用于需要上传文件的同时发送其他数据的情况。multipart/form-data。对于请求 Body 中的每个参数,你可以选择其类型,如字符串、整数等。string,然后在字段的参数值中填入 JSON。x-www-form-urlencoded 数据。string类型,如果需要添加子节点,需要将字段设置成 object 或 array 类型。raw 选项允许在请求体 (Body) 中发送任何自定义数据格式。这对于处理一些期望特定数据结构或格式的 API 非常有用,尤其是当这些结构或格式不属于其他选项覆盖的范围时。