在本篇中你将学会如何设计自己的超媒体接口，同时学会如何利用Apiary来创建专业的接口文档。 在实现自己的接口前完成一份专业的API文档十分重要。第一，实现接口前你需要考虑到客户端访问API的最佳方式，从而得出最好的设计方案，如果没有提前写好的设计文档，直接完成的API的就会过…

RESTful 是目前最流行的 API 设计规范，用于 Web 数据接口的设计。它的大原则容易把握，但是细节不容易做对。 本文总结 RESTful 的设计细节，介绍如何设计出易于理解和使用的 API。 RESTful 的核心思想就是，客户端发出的数据操作指令都是"动词 + 宾语…

API 设计是一个都快被说烂了的主题，已经有太多关于对 Web API 做版本控制很棒的文章了。比如： 但今天这里还是想分享一篇，希望看完能有所收获。: ) RESTful。 通过解析 URI 中的版本号，客户端可以访问/v1/或/v2/等不同版本API。 不进行版本控制很有可…

设计Web API不止是URL、HTTP状态码、头信息和有效负载。设计的过程--基本上是为了你的API“观察和感受” -- 这非常重要，并且值得你付出努力。本文简要概括了一种同时发挥HTTP和Web两者优势的API设计方法论。

当我们开始从事 API 开发的时候，设计问题便出现了. 一个强而有力的 API 设计方法是 API 成功的关键要素. 设计糟糕的 API 会导致 API 滥用问题，或者更糟：API 根本没人使用 (指 Web 开发者).

在过去几年间，REST 规范的各种语言正在逐渐流行起来，例如 RAML、Swagger 以及 API Blueprint。但这些语言的主要范畴在于客户端工具，主要用于生成 JavaScript 或 TypeScript 文件、模拟对象（mock），以及对应的客户端单元测试。

介绍了一下 RESTful API 的最佳实践。

随着移动开发和前端开发的崛起，越来越多的 Web 后端应用都倾向于实现 Restful API。 Restful API 是一个简单易用的前后端分离方案，它只需要对客户端请求进行处理，然后返回结果即可， 无需考虑页面渲染，一定程度上减轻了后端开发人员的负担。

在 RESTful API 中，API 接口应该尽量兼容之前的版本。但是，在实际业务开发场景中，可能随着业务需求的不断迭代，现有的 API 接口无法支持旧版本的适配，此时如果强制升级服务端的 API 接口将导致客户端旧有功能出现故障。实际上，Web 端是部署在服务器，因此它可以…