restful风格的api

[TOC]

请求 = 动词 + 宾语

动词 使用五种 HTTP 方法,对应 CRUD 操作。

宾语 URL 应该全部使用名词复数

image-20201204193457082

使用 HTTP 的状态码

客户端的每一次请求,服务器都必须给出回应。回应包括 HTTP 状态码和数据两部分。

image-20201204193514554

服务器回应数据

客户端请求时,要明确告诉服务器,接受 JSON 格式,请求的 HTTP 头的 ACCEPT 属性要设成 application/json

服务端返回的数据,不应该是纯文本,而应该是一个 JSON 对象。服务器回应的 HTTP 头的 Content-Type 属性要设为 application/json

image-20201204193625778