• RESTful API 设计规范理解


    RESTful 是一种共识和 http里的URL 的规范。

    网站里  : 使用GET、POST的选择点在于,简单的用GET、复杂对象用POST

    REST里: GET对应的是查询一个资源,而POST对应的是新增一个资源

    例子:

    网站 get_user?id=3

    REST: GET /user/3 (GET是HTTP类型)

    RESTFul API 特点

    1. 使用HTTP动词表示增删改查资源, GET:查询,POST:新增,PUT:更新,DELETE:删除

    2. 返回结果必须使用JSON

    3. HTTP状态码,在REST中都有特定的意义:200,201,202,204,400,401,403,500。比如401表示用户身份认证失败,403表示你验证身份通过了,但这个资源你不能操作。

    4. 如果出现错误,返回一个错误码。比如我通常是这么定义的:

    1. API必须有版本的概念,v1,v2,v3
    2. 使用Token令牌来做用户身份的校验与权限分级,而不是Cookie。
    3. url中大小写不敏感,不要出现大写字母
    4. 使用 - 而不是使用 _ 做URL路径中字符串连接。
    5. 有一份漂亮的文档~(很重要)

    接口设计是一个非常依赖于经验和重构的技术活儿
    设计接口需要有一些艺术家的天赋
    你看GitHub的接口就非常的“美”,不要觉得很简单,真的比写代码还难。
    难道大家不觉得,有时候起名字真的是一件很难的事儿嘛?

  • 相关阅读:
    记一次dba面试
    MySQL登陆 socket 问题
    推荐一些MySQL的博文(持续更新)
    MySQL 参数调优工具--tuning-primer
    当扫描的数据超过了全表的17%就不使用索引
    MySQL 5.7 新增参数
    MySQL 5.7 和 MySQL 5.6参数默认值比较
    MySQL创建的用户无法从本地登陆
    含有IN的子查询
    索引大小对语句执行速度的影响
  • 原文地址:https://www.cnblogs.com/ajk4/p/12916738.html
Copyright © 2020-2023  润新知