RESTful API设计规范

RESTful 是目前最流行的 API 设计规范,用于 Web 数据接口的设计

它的大原则容易把握,但是细节不容易做对。本文总结 RESTful 的设计细节,介绍如何设计出易于理解和使用的 API。

一 URL设计 动词+宾语

  RESTful的核心思想就是,客户端发出的数据+操作指令都是“动词+宾语”的结构,比如GET /articles这个命令,GET是动词,/articles是宾语,动词通常就有5种HTTP请求方法,对应CRUD操作,根据 HTTP 规范,动词一律大写。

# GET:读取(Read) # POST:新建(Create) # PUT:更新(Update) # PATCH:更新(Update),通常是部分更新 # DELETE:删除(Delete)

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wpssfz.html