美文网首页
设计HTTP API

设计HTTP API

作者: Edviin_2de8 | 来源:发表于2019-03-04 16:16 被阅读0次

    当客户端向服务器发起HTTP请求的时候,请求的Header中会有一个字段叫Request Method,也叫做HTTP verb或者请求方式。
    不同的HTTP verbs表达了不同的HTTP请求意图

    GET

    GET,表示客户端需要请求服务器的某个资源。简单来说,就是当我们需要给用户显示某些保存在服务器上的内容时,都会向服务器发起GET请求;

    post

    POST,表示向服务器提交数据,例如用户注册时填写的信息、登录时填写的用户名/密码等。简单来说,就是当我们需要根据用户输入在服务器上创建新记录的时候,都会向服务器发起POST请求;

    PUT或PATCH

    PUT或PATCH,之所以把它们放在一起,是因为它们都表示根据用户提供的内容,修改服务器上的特定资源;现在,可以把它们的区别简单理解成,通过PUT请求修改要求提供的数据是全量的,例如当我们修改某条数据库记录时,使用PUT请求,应该包含这条记录的所有字段,这种修改更像是覆盖;而使用PATCH请求提交的内容则是有针对性的,只要提供需要的部分就好了;

    DELETE

    DELETE,表示请求服务器删除特定的内容,例如文件或者数据库中的某个字段等;

    当然,这里说的HTTP verb和对应请求的含义,只是一种约定俗成的东西,这种约定俗成的规范,使得互联网上的各种基于HTTP的服务器有统一的应用形式。但是,并没有人可以阻止你就通过POST请求修改或删除自己服务器上的内容,只是你这么做出来的HTTP API,会给其它的服务端开发者不那么“地道”的感觉罢了。所以,在学习服务端开发之初,就应该建立起这种意识,在设计HTTP API的时候,使用正确的HTTP verbs。

    设计HTTP APIs时应遵信的一些命名规范。其中,最重要的一个大原则就是,永远使用名词表示API管理的资源

    相关文章

      网友评论

          本文标题:设计HTTP API

          本文链接:https://www.haomeiwen.com/subject/qfpiuqtx.html