> 文章列表 > REST与RESTFul

REST与RESTFul

REST与RESTFul

什么是REST

        Representational State Transfer: 表述性状态转移

        一种风格、约束、设计理念

        通常来说,使用JSON描述数据

        无状态

        基于资源,增删改查都只是对于资源状态的改变
        使用HTTP动词来操作资源

        /getmovie/:mid (错误,不能用动词)
        GET: /movie/;mid(正确,应该用名词)

RESTFul API最佳实践
        @HTTP动词( 幂等性、资源安全性)
        POST: 创建
        PUT: 更新
        GET:查询
        DELETE: 删除

        状态码:404、400、200、201、202、401、403、500
        错误码:自定义的错误ID号
        统一描述错误:错误码、错误信息、当前URL

        使用Token令牌来授权和验证身份
        版本控制
        测试与生产环境分开:api.xxx.comdev.api.xxx.com

        URL语义要明确,最好可以“望文知意
        最好是有一份比较标准的文档

        学习RESTFulAPI的最佳方式:模仿

         豆瓣开放API
         GitHub 开发者API

        RESTFulAPI的合理使用(切勿盲目照搬标准REST)