接口文档对接__参数

参数常见枚举值

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。

表单参数(Form Parameters):这些参数通常包含在 HTTP 请求的消息主体(body)中,而不是直接附加在 URL 中。

curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "username=admin&password=123456" https://example.com/login
---------------------------------------
解释一下这个命令:
    -X POST:表示使用POST方法发送请求。
    -H "Content-Type: application/x-www-form-urlencoded":表示设置请求头中的Content-Type为表单参数类型。
    -d "username=admin&password=123456":表示发送表单参数,其中username为admin,password为123456。
    https://example.com/login:表示请求的接口地址

请求头参数(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 替换为实际的文件路径
# curl 命令,通常不需要显式设置 Content-Type 为 multipart/form-data。当使用 -F 选项上传文件时,curl 会自动设置合适的 Content-Type 头为 multipart/form-data

在接口对接时,通常而言我们需要确定以下要素就可以实现接口的成功调用。

请求方法HTTP Methods

请求头HTTP Headers

请求参数Request Parameters

请求路径Request Path

对于请求参数的一些细节,希望此文可以提供一些帮助。

posted @ 2023-12-07 11:24  Ashe|||^_^  阅读(148)  评论(0编辑  收藏  举报