实战目标
- 企业微信的部门管理接口测试
课程ppt
HTTP 响应的状态码
HTTP状态码(英语:HTTP Status Code)是用以表示网页服务器超文本传输协议响应状态的 3 位数字代码。所有状态码的第一个数字代表了响应的五种状态之一。
1xx(临时响应)
表示临时响应并需要请求者继续执行操作的状态代码。一般是告诉客户端,请求已经收到了,正在处理,别急…
- 100 (继续) 请求者应当继续提出请求。 服务器返回此代码表示已收到请求的第一部分,正在等待其余部分。
- 101 (切换协议) 请求者已要求服务器切换协议,服务器已确认并准备切换。
我们平常遇到这种响应状态码的时候很少。因为 HTTP/1.0 协议中没有定义任何 1xx 状态码,所以除非在某些试验条件下,服务器是不可以向此类客户端发送 1xx 响应的。
2XX (成功)
都表示服务器成功处理了请求的状态代码,说明网页可以正常访问。一般表示:请求收悉、我明白你要的、请求已受理、已经处理完成等信息。
- 200(成功) 找到了该资源,并且一切正常,服务器已成功处理了请求。
- 201(已创建) 请求成功且服务器已创建了新的资源。
- 202(已接受) 服务器已接受了请求,但尚未对其进行处理。
- 203(非授权信息) 服务器已成功处理了请求,但返回了可能来自另一来源的信息。
- 204(无内容) 服务器成功处理了请求,但未返回任何内容。
- 205(重置内容) 服务器成功处理了请求,但未返回任何内容。与 204 响应不同,此响应要求请求者重置文档视图(例如清除表单内容以输入新内容)。
- 206(部分内容) 服务器成功处理了部分 GET 请求。
3xx (重定向)
表示要完成请求,需要进一步操作。需要重定向到其它地方。它让客户端再发起一个请求以完成整个处理
- 300 (多种选择) 针对请求,服务器可执行多种操作。 服务器可根据请求者 (user agent) 选择一项操作,或提供操作列表供请求者选择。
- 301 (永久移动) 请求的网页已永久移动到新位置。 服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新位置。
- 302 (临时移动) 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
- 303 (查看其他位置) 请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码。
- 304 (未修改) 自从上次请求后,请求的网页未修改过。 服务器返回此响应时,不会返回网页内容。这通常用于浏览器的缓存机制
- 305 (使用代理) 请求者只能使用代理访问请求的网页。 如果服务器返回此响应,还表示请求者应使用代理。
- 307 (临时重定向) 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
4xx(请求错误)
这些状态代码表示请求可能出错,责任在客户端,如客户端的请求一个不存在的资源,客户端未被授权,禁止访问等,妨碍了服务器的处理。
- 400 (错误请求) 服务器不理解请求的语法。
- 401 (未授权) 请求要求身份验证。对于需要登录的网页,服务器可能返回此响应。 要求用户输入用户名和密码,以登录到服务器。
- 403 (禁止) 服务器拒绝请求。客户端未能获得授权。这通常是在401之后输入了不正确的用户名或密码。
- 404 (未找到) 服务器找不到请求的网页。在指定的位置不存在所申请的资源。
- 405 (方法禁用) 禁用请求中指定的方法。
- 406 (不接受) 无法使用请求的内容特性响应请求的网页。
- 407 (需要代理授权) 此状态代码与 401(未授权)类似,但指定请求者应当授权使用代理。
- 408 (请求超时) 服务器等候请求时发生超时。
- 409 (冲突) 服务器在完成请求时发生冲突。 服务器必须在响应中包含有关冲突的信息。
- 410 (已删除) 如果请求的资源已永久删除,服务器就会返回此响应。
- 411 (需要有效长度) 服务器不接受不含有效内容长度标头字段的请求。
- 412 (未满足前提条件) 服务器未满足请求者在请求中设置的其中一个前提条件。
- 413 (请求实体过大) 服务器无法处理请求,因为请求实体过大,超出服务器的处理能力。
- 414 (请求的 URI 过长) 请求的 URI(通常为网址)过长,服务器无法处理。
- 415 (不支持的媒体类型) 请求的格式不受请求页面的支持。
- 416 (请求范围不符合要求) 如果页面无法提供请求的范围,则服务器会返回此状态代码。
- 417 (未满足期望值) 服务器未满足”期望”请求标头字段的要求。
5xx(服务器错误)
处理发生错误,责任在服务端,如服务端抛出异常,路由出错,HTTP版本不支持等
- 500 (服务器内部错误) 服务器遇到错误,无法完成请求。 看到这个错误,你就应该查查服务端的日志了,肯定抛出了一堆异常
- 501 (尚未实施) 服务器不具备完成请求的功能。 例如,服务器无法识别请求方法时可能会返回此代码。
- 502 (错误网关) 服务器作为网关或代理,从上游服务器收到无效响应。
- 503 (服务不可用) 服务器目前无法使用(由于超载或停机维护)。 通常,这只是暂时状态。
- 504 (网关超时) 服务器作为网关或代理,但是没有及时从上游服务器收到请求。
- 505 (HTTP 版本不受支持) 服务器不支持请求中所用的 HTTP 协议版本。
REST 规范
- Roy_Fielding:https://en.wikipedia.org/wiki/Roy_Fielding
- 论文:Architectural Styles and the Design of Network-based Software Architectures
- RESTful API 设计指南 - 阮一峰的网络日志
测试用例与postman脚本
部门管理接口测试用例.xlsx (14.1 KB)
depart_data.zip (15.0 KB)