接口文档对接__参数

发布时间 2023-12-07 11:51:26作者: ashet

参数常见枚举值

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 替换为实际的文件路径