首页 > 其他 > 详细

RESTful 规范

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

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 规范

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

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!