Season 1: 启航
加更: 聊聊 APILetter 的新计划
APILetter 也走过了最难的一年。接下来,尽是坦途。
Season 1: 启航
OpenAPI 是一项非常重要的任务,不能马马虎虎。一个坏的设计会让团队持续在 OpenAPI 开发上投入更多的精力。
Season 1: 启航
在 RESTFul 风格下去做批量操作,也有两种不同的设计思路。你 Pick 哪一个?
开发者体验
好的错误码设计是适度的,你需要学会平衡错误码和对应错误信息的数量,不要太多干扰开发者,但也不可太少,不足以支撑实际的接口调用。
Season 1: 启航
好的开发者文档,应该分为 Reference、Guide 和 Tutorial
Season 1: 启航
如果我们可以降低开发者在完成开放能力接入所需的时间,我们就可以让开发者有更多的时间去构建属于自己的业务逻辑,拓展平台之上的应用生态和开发者体验。
Season 1: 启航
如果说用一个偷懒的想法,那我们可以得出一个结论 —— RESTful 一定做对了什么,不然不会这么多平台都愿意选择它。
一个专注于讨论 API 生态、API 设计的 Newsletter