RESTful的一些总结

来源:互联网 发布:淘宝退款不退货会怎样 编辑:程序博客网 时间:2024/05/29 16:44

关于RESTful

  RESTful架构,是当下比较流行的一种架构。稍微总结一下我用到的地方

  首先是API与用户的通信协议,总是使用https协议。不推荐所有的网络请求都使用https,据说和http比会慢2-100倍,也浪费了资源,比较敏感的地方使用即可。

  将API的版本号放入URL中。我也见过将版本号放入header的用法,都能实现升级API版本的需求,不过放到URL中更加直观一些。

  网址中不能有动词,只能有名词。(个人理解规范)####  对于资源的具体操作,由HTTP动词表示。

  服务器向用户返回的状态码和提示信息。开发和调试的时候,对各种情况的网络请求处理起来会很方便。当然了现在大部分都是这么玩的吧。

  服务器返回的数据格式,应该尽量使用JSON,避免使用XML。很少见到返回XML的网络请求了,现在都是JSON了。

  如果状态码是4xx,就应该向用户返回出错信息。一般来说,返回的信息中将error作为键名,出错信息作为键值即可。更友好的提示用户出错的原因,不是单纯的网络错误,稍后重试。

原创粉丝点击