参数常见枚举值
O(Optional):表示参数是可选的。
M(Mandatory):表示参数是必填的。
其他可能的枚举值
R(Required):与“M”相似,表示参数是必需的。
C(Conditional):表示参数的必填性取决于其他参数的值或某些条件。
D(Default):表示参数有默认值,当你不提供该参数,接口将使用默认值进行处理。
E(Either/Or):表示一组参数中仅允许提供其中之一,不能同时提供多个。
A(At least one):表示一组参数中至少提供一个,但允许提供多个。
参数类型
url参数(Uniform Resource Locator parameters):通常出现在 URL 的问号(?)之后,并且多个参数之间使用和符号(&)分隔。
curl https://example.com/page?name=John&age=25
body参数(json格式请求体)
curl -X POST -H "Content-Type: application/json" -d '{"key1":"value1","key2":"value2"}' https://example.com/api/resource
-X POST 指定使用 POST 方法。
-H "Content-Type: application/json" 设置请求头,告诉服务器请求的 body 数据是 JSON 格式。
-d '{"key1":"value1","key2":"value2"}' 指定请求的 body 数据,这里是一个 JSON 字符串。
https://example.com/api/resource 是目标 API 的 URL。
请求头参数(Header Parameters):需要放置在请求头中的参数,比如身份验证令牌/用户代理信息等。
curl -H "Authorization: Bearer your_access_token" https://example.com/api/resource
路径参数(Path Parameters)
# https://example.com/users/{userId}
# 在这个例子中,{userId} 就是路径参数,实际的请求URL可能是类似于
curl https://example.com/users/123
文件上传参数(File Upload Parameters)
curl -X POST -H "Authorization: Bearer your_access_token" -F "file=@file.txt" https://example.com/api/upload
# file 是接口预期接收文件的字段名
# @file.txt 指定了上传的文件路径。你需要将 file.txt 替换为实际的文件路径