本文最后更新于 1459 天前,其中的信息可能已经有所发展或是发生改变。
介绍
web的状态码用来针对不同情况的一个响应,本文介绍在python的web.py框架中状态码的变更修改。
状态码
1XX-临时响应
表示临时响应并需要请求者继续执行操作的状态代码。
代码 | 说明 |
---|---|
100 (继续) | 请求者应当继续提出请求。服务器返回此代码表示已收到请求的第一部分,正在等待其余部分。 |
101 (切换协议) | 请求者已要求服务器切换协议,服务器已确认并准备切换。 |
2XX-成功
表示成功处理了请求的状态代码。
代码 | 说明 |
---|---|
200 (成功) | 服务器已成功处理了请求。通常,这表示服务器提供了请求的网页。 |
201 (已创建) | 请求成功并且服务器创建了新的资源。 |
202 (已接受) | 服务器已成功处理了请求,但返回的信息可能来自另一来源。 |
203 (非授权信息) | 服务器已成功处理了请求,但返回的信息可能来自另一来源。 |
204 (无内容) | 服务器成功处理了请求,但没有返回任何内容。 |
205 (重置内容) | 服务器成功处理了请求,但没有返回任何内容。 |
206 (部分内容) | 服务器成功处理了部分 GET 请求。 |
3XX-重定向
表示要完成请求,需要进一步操作。 通常,这些状态代码用来重定向。
代码 | 说明 |
---|---|
300 (多种选择) | 针对请求,服务器可执行多种操作。服务器可根据请求者 (user agent) 选择一项操作,或提供操作列表供请求者选择。 |
301 (永久移动) | 请求的网页已永久移动到新位置。服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新位置。 |
302 (临时移动) | 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。 |
303 (查看其他位置) | 请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码。 |
304 (未修改) | 自从上次请求后,请求的网页未修改过。服务器返回此响应时,不会返回网页内容。 |
305 (使用代理) | 请求者只能使用代理访问请求的网页。如果服务器返回此响应,还表示请求者应使用代理。 |
307 (临时重定向) | 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。 |
4XX-请求错误
代码 | 说明 |
---|---|
400 (错误请求) | 服务器不理解请求的语法。 |
401 (未授权) | 请求要求身份验证。 对于需要登录的网页,服务器可能返回此响应。 |
403 (禁止) | 服务器拒绝请求。 |
404 (未找到) | 服务器找不到请求的网页。 |
405 (方法禁用) | 禁用请求中指定的方法。 |
406 (不接受) | 无法使用请求的内容特性响应请求的网页。 |
407 (需要代理授权) | 此状态代码与 401(未授权)类似,但指定请求者应当授权使用代理。 |
408 (请求超时) | 服务器等候请求时发生超时。 |
409 (冲突) | 服务器在完成请求时发生冲突。服务器必须在响应中包含有关冲突的信息。 |
410 (已删除) | 如果请求的资源已永久删除,服务器就会返回此响应。 |
411 (需要有效长度) | 服务器不接受不含有效内容长度标头字段的请求。 |
412 (未满足前提条件) | 服务器未满足请求者在请求中设置的其中一个前提条件。 |
413 (请求实体过大) | 服务器无法处理请求,因为请求实体过大,超出服务器的处理能力。 |
414 (请求的 URI 过长) | 请求的 URI(通常为网址)过长,服务器无法处理。 |
415 (不支持的媒体类型) | 请求的格式不受请求页面的支持。 |
416 (请求范围不符合要求) | 如果页面无法提供请求的范围,则服务器会返回此状态代码。 |
417 (未满足期望值) | 服务器未满足”期望”请求标头字段的要求. |
5XX-服务器错误
代码 | 说明 |
---|---|
500 (服务器内部错误) | 服务器遇到错误,无法完成请求。 |
501 (尚未实施) | 服务器不具备完成请求的功能。例如,服务器无法识别请求方法时可能会返回此代码。 |
502 (错误网关) | 服务器作为网关或代理,从上游服务器收到无效响应。 |
503 (服务不可用) | 服务器目前无法使用(由于超载或停机维护)。通常,这只是暂时状态。 |
504 (网关超时) | 服务器作为网关或代理,但是没有及时从上游服务器收到请求。 |
505 (HTTP 版本不受支持) | 服务器不支持请求中所用的 HTTP 协议版本。 |
返回类型
content-type
常见格式
代码 | 说明 |
---|---|
text/html | HTML格式 |
text/plain | 纯文本格式 |
text/xml | XML格式 |
image/gif | gif图片格式 |
image/jpeg | jpg图片格式 |
image/png | png图片格式 |
application格式
代码 | 说明 |
---|---|
application/xhtml+xml | XHTML格式 |
application/xml | XML数据格式 |
application/atom+xml | Atom XML聚合格式 |
application/json | JSON数据格式 |
application/pdf | pdf格式 |
application/msword | Word文档格式 |
application/octet-stream | 二进制流数据(如常见的文件下载) |
application/x-www-form-urlencoded | form encType=””中默认的encType,form表单数据被编码为key/value格式发送到服务器(表单默认的提交数据的格式) |
上传文件格式
代码 | 说明 |
---|---|
multipart/form-data | 需要在表单中进行文件上传时,就需要使用该格式 |
web.py
自定义404
在入口的程序,即主应用添加如下内容。
下面是自定义404json返回。
def notfound():
#404错误
result = {'status': 'error', 'msg': '不存在的API接口'}
return web.HTTPError("404 Not Found",{"Content-Type":"application/json"},json.dumps(result))
自定义500
在入口的程序,即主应用添加如下内容。
下面是自定义500json返回。
def internalerror():
#500错误
result = {'status': 'error', 'msg': '服务器错误'}
return web.HTTPError("500 Internal Server Error",{"Content-Type":"application/json"},json.dumps(result))
自定义返回类型
返回类型为json
web.header('Content-Type', 'application/json')
自定义返回状态码
400:
web.HTTPError("400 Bad Request")
401:
web.HTTPError("401 Unauthorized")
403:
web.HTTPError("403 Forbidden")
406:
web.HTTPError("406 Not Acceptable")