restful 风格api

1.  什么是rest

        REST -- REpresentational State Transfer

        首先,之所以晦涩是因为前面主语被去掉了,全称是 Resource Representational State Transfer:
       通俗来讲就是:资源在网络中以某种表现形式进行状态转移。
       分解开来:
                Resource:资源,即数据。比如 newsfeed,friends等;
                Representational:某种表现形式,比如用JSON,XML,JPEG等;
                State Transfer:状态变化。通过HTTP动词实现。
        URL定位资源,用HTTP动词(GET,POST,DELETE,DETC)描述操作。

2. 为什么要用rest

        为web, iso,andriod统一开发接口,前后端分离

3. 设计原则

         a. url 加版本号:url/v1

         b. 名词:url/v2/friends

         

设计 RESTful 风格 API 的 URL,通常需要考虑以下几个方面: 1. 遵循 URL 的命名规范:URL 命名应该简洁易懂,采用小写字母和短划线进行分隔。 2. 使用名词表示资源:RESTful API 设计中的 URL 应该是名词,而不是动词。例如,使用 `/users` 表示用户资源,而不是 `/get_users`。 3. 使用 HTTP 动词表示操作:RESTful API 设计中的 HTTP 方法应该表示所要执行的操作。例如,使用 HTTP GET 方法获取资源,使用 POST 方法创建资源,使用 PUT 方法更新资源,使用 DELETE 方法删除资源。 4. 使用路径参数和查询参数:使用路径参数表示资源的唯一标识符,使用查询参数表示对资源的筛选和排序操作。 下面以一个简单的例子说明如何设计 RESTful 风格 API 的 URL: 假设我们要设计一个博客网站的 API,其中包含文章和评论两个资源。文章可以被创建、查看、更新和删除,评论可以被创建和查看。 文章资源的 URL 设计如下: - 获取所有文章:`GET /articles` - 获取指定 ID 的文章:`GET /articles/:id` - 创建文章:`POST /articles` - 更新指定 ID 的文章:`PUT /articles/:id` - 删除指定 ID 的文章:`DELETE /articles/:id` 评论资源的 URL 设计如下: - 获取指定文章的所有评论:`GET /articles/:article_id/comments` - 创建评论:`POST /articles/:article_id/comments` - 获取指定 ID 的评论:`GET /articles/:article_id/comments/:id` 在上述例子中,使用了路径参数和查询参数来表示资源的唯一标识符和对资源的操作。同时,HTTP 方法也清晰地表示了对资源的操作类型。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值