HTTP接口

HTTP接口

HTTP请求由三部分组成，分别是：请求地址、消息报头 、请求正文。

HTTP响应也是由三个部分组成，分别是：状态码、消息报头、响应正文。

在HTTP请求的返回数据包中，响应状态码分为以下5种。·

 1xx：消息。一般是告诉客户端，请求已经收到了，正在处理，别急……· 

2xx：处理成功。一般表示请求收悉、我明白你要的、请求已受理、已经处理完成等信息。· 

3xx：重定向到其他地方。它让客户端再发起一个请求，以完成整个处理过程。·

 4xx：处理发生错误，错误来自客户端。例如，客户端请求的是一个不存在的资源、客户端未被授权、禁止访问等。

· 5xx：处理发生错误，错误来自服务器端。例如，服务器端抛出异常、路由出错、HTTP版本不支持等。

HTTP中有四种发送请求的方式：GET、POST、PUT和DELETE。（1）GET：向特定的资源发出请求。（2）POST：向指定资源提交“数据进行处理”请求（例如，提交表单或者上传文件），数据被包含在请求体中。POST请求可能导致新的资源的创建，以及（也可能是“或”）已有资源的修改。（3）PUT：向指定资源位置上传其最新内容。（4）DELETE：请求服务器执行删除操作。

接口文档

主要包含以下内容。

（1）接口功能：对接口作用的大概描述，使人一眼就知道该接口的作用。（2）接口URL：即接口的请求地址。一般都是相对地址，便于在不同环境之间切换。（3）请求方法：一般的HTTP的请求方法是POST或GET。（4）请求参数：包含参数类型及其限制条件。（5）返回包数据的实例。（6）返回码的解释。