码迷,mamicode.com
首页 > 其他好文 > 详细

RESTful 规范

时间:2018-07-23 17:21:16      阅读:173      评论:0      收藏:0      [点我收藏+]

标签:nbsp   设置   约束   media   进一步   get   过滤   数据库   跳转   

 

RESTful 规范

  一种软件的架构风格,设计风格,而不是标准,为客户端和服务端的交互提供一组设计原则和约束条件。

一  面向资源编程

  每个URL代表一种资源,URL中尽量不要用动词,要用名词,往往名词跟数据库表格相对应。

二  根据method不同,进行不同的操作

  GET/POST/PUT/DELETE/PATCH

三  在URL中体现版本

  https://www.bootcss.com/v1/mycss

  https://v1.bootcss.com/mycss

四  在URL中体现是否是API

  https://www.bootcss.com/api/mycss

  https://api.bootcss.com/mycss

五  在URL中的过滤条件

  https://www.bootcss.com/v1/mycss?page=3

六  尽量使用HTTPS

  https://www.bootcss.com/v1/mycss

七  响应时设置状态码

  1**   信息,服务器收到请求,需要请求者继续执行操作

  2**  成功,操作被成功接收并处理

  3**  重定向,需要进一步的操作以完成请求

  4**  客户端错误,请求包含语法错误或无法完成请求

  5**  服务器错误,服务器在处理请求的过程中发生了错误

八  返回值

  GET请求 返回查到所有或单条数据

  POST请求  返回新增的数据

  PUT请求  返回更新数据

  PATCH请求  局部更新  返回更新整条数据

  DELETE请求  返回值为空

九  返回错误信息

  返回值携带错误信息

十   Hypermedia API

  如果遇到需要跳转的情况 携带调转接口的URL

  ret = {
                code: 1000,
                data:{
                    id:1,
                    name:‘小强‘,
                    depart_id:http://www.luffycity.com/api/v1/depart/8/
                }
            }

RESTful 规范

标签:nbsp   设置   约束   media   进一步   get   过滤   数据库   跳转   

原文地址:https://www.cnblogs.com/wzbk/p/9355439.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!