一,HTTP 参数
为什么要说一说这个呢?是因为前几天开发的时候开接口文档里的请求头参数、路径参数之类的区别有点没分清加上最近还有遇到了一个参数格式书写的问题,就想着写写记录一下。
1,分类
请求头参数(head)
顾名思义就是放在请求头 header 里的参数,常用的像:Content-Type(内容数据格式)、Cookie、Authorization(一般用在登陆凭证)。
注意这里的 Content-Type 对应的是服务器解析参数的方式,也就是说你传给服务器值,你告诉服务器怎么处理识别值。
Content-Type(常见,还有更多的) 内容格式 产生结果 application/form 表单类型,服务器默认解析方式,但是它不会接在 url 后面 username=lzz&password=123 text/plain 文本值,服务器将请求体当成普通字符串 hello world application/json 服务器将请求体当成 json 值 {“username”=”lzz”,”password”=123} application/xml 服务器将请求体当成 xml 格式值 xxx text/html 服务器将请求体当成 html 格式 xxx 注意:form 格式这种情况需要对中文和/ : ? # + =之类的特殊字符进行转义,有点类似于路径参数和查询参数
路径参数(path)
就是接口 url 地址(去掉基地址的部分)
比如:https://mlhiter.top/2022/detail,其中的/2022/detail就是路径参数
注意:路径参数里的中文或者特殊符号+:/?之类的要进行转移,不然会和原本用在路径里的格式冲突,下面的查询参数也需要。
查询参数(query)
放在 url 地址最后的,以键值对形式存在。
请求体参数(body)
放在请求体中的参数。
参数的格式可以通过在请求头参数的 Content-Type 设置其格式。我们在请求体格式里也可以设置格式
注意:我这里出现了一个问题没注意
apifox里在 body 参数界面的参数格式要和请求头里的 Content-Type 值相同,如果冲突的话会优先选择 body 界面的请求体类型,而不是选择 Content-Type 设置的值,这里还有一个 raw 的类型,设置他之后 Content-Type 的值就可以生效了。
二,HTTP 错误
总结了一下常见的错误码情况。
1,常见错误码
- 405
- 意思:资源被禁止,请求方法错误。(Method Not Allowed)
- 解决方法:
- 最常见原因是输入 url 错误。