【文件属性】:
文件名称:rest-api-design-guidelines:REST API设计准则
文件大小:5KB
文件格式:ZIP
更新时间:2021-05-19 13:58:43
REST API设计准则
介绍
本文档为应用程序编程接口(API)定义了一组设计准则。 本文档介绍了用于指导REST API规范的约定和设计模式,以及指导原则。 作为设计准则,此处的内容未描述特定的实现或特定的API规范。 而是,指南描述了API规范和相关实现必须遵循的属性,以便被认为符合某些标准。
为什么API设计很重要?
API可能是公司最大的资产之一
客户大量投资:购买,写作,学习
停止使用API的成本可能令人望而却步
成功的公共API可以吸引客户
也可能是公司最大的负债之一
错误的API会导致无休止的支持电话流
公开的API永远存在-一种正确的机会
通过API进行思考可以提高代码质量
优质API的特征
简单易学。 API语义必须直观
易于使用,即使没有文档也是如此。 不应有不同的方式来完成相同的操作
难以滥用
易于阅读和维护使用它的代码
足够强大,可以满足要求
易于扩展
适合
【文件预览】:
rest-api-design-guidelines-master
----README.md(12KB)