Web API设计

　　目录
　　前言 1
　　第1 章 什么是API 9
　　为什么我们需要API 10
　　谁是我们的用户 10
　　API 的商业案例 11
　　内部开发者优先使用，外部开发者次之的API 12
　　外部开发者优先使用，内部开发者次之的API 13
　　作为产品的API 14
　　如何让API 更出色 15
　　小结 16
　　第2 章 API 范式 17
　　请求?C 响应式API 17
　　表现层状态转换REST 18
　　远程过程调用RPC 21
　　GraphQL 22
　　事件驱动式API 28
　　WebHooks 28
　　WebSocket 31
　　HTTP Streaming 32
　　小结 34
　　第3 章 API 安全 37
　　身份认证和授权 37
　　OAuth 39
　　令牌生成 40
　　权限范围 42
　　令牌和权限范围验证 44
　　令牌过期和令牌刷新 46
　　展示和撤销授权 47
　　OAuth 实践 48
　　WebHooks 安全 52
　　令牌验证 52
　　请求签名和WebHooks 签名 53
　　双向传输层安全 54
　　精简负载和API 获取 55
　　WebHooks 安全实践 55
　　小结 56
　　第4 章 设计实践 57
　　基于真实用例而设计 57
　　设计出色的开发者体验 58
　　使API 能快速而轻松地入门 59
　　保持一致性60
　　简化故障排除过程 62
　　让你的API 可扩展 66
　　小结 69
　　第5 章 设计实践 71
　　场景1 72
　　定义业务目标 72
　　概述关键用例 74
　　选择技术架构 75
　　编写API 规范 78
　　场景2 83
　　定义问题 83
　　概述关键用例 84
　　选择技术架构 84
　　编写API 规范 85
　　验证你的决定 88
　　小结 90
　　第6 章 扩展API 91
　　扩展吞吐量 92
　　找到瓶颈 93
　　添加计算资源 95
　　数据库索引96
　　高速缓存 97
　　异步执行昂贵的操作 99
　　优化API 设计100
　　介绍新的数据访问模式 100
　　添加新的API 方法 102
　　支持批量端点 105
　　添加可以筛选结果的新选项 105
　　API 分页 107
　　基于偏移量的分页 107
　　基于游标的分页 109
　　API 分页的实践和技巧 112
　　API 速率限制 112
　　什么是速率限制 113
　　实现策略 115
　　固定窗口计数器算法 117
　　速率限制与开发者 120
　　速率限制实践和技巧 122
　　开发者SDK 124
　　速率限制支持 124
　　分页支持 125
　　使用gzip 125
　　缓存常用数据 125
　　错误处理和指数后退 125
　　开发者SDK 的实践和技巧 126
　　小结 126
　　第7 章 管理更新 129
　　向上一致性 130
　　自动化测试 133
　　向下兼容性 139
　　计划和沟通更新 141
　　沟通计划 141
　　添加 143
　　删除 144
　　小结 154
　　第8 章 构建开发者生态系统 155
　　开发者，开发者，开发者 156
　　业余爱好者157
　　黑客 157
　　以业务为中心、技术精湛的用户 157
　　专业开发者158
　　更多受众 158
　　构建开发者关系策略 159
　　开发者细分159
　　市场规模和地域分布 161
　　提炼价值主张 163
　　定义开发者漏斗 164
　　映射当前状态和未来状态 167
　　策略概述 168
　　推导测量 172
　　小结 173
　　第9 章 开发者资源 175
　　API 文档 175
　　入门指南 176
　　参考文档 178
　　教程 179
　　常见问题 180
　　登录页面 181
　　更新日志 182
　　服务条款 184
　　代码示例和代码片段 185
　　代码示例 185
　　代码片段 186
　　软件开发套件和框架 187
　　软件开发工具包（SDK） 188
　　框架 189
　　开发工具 191
　　调试和故障排除 191
　　沙箱和API 测试人员 191
　　富媒体 192
　　视频 192
　　答疑时间 193
　　网络研讨会和在线培训 194
　　社区贡献 194
　　小结 196
　　第10 章 开发者计划 197
　　定义开发者计划 197
　　广度和深度分析 197
　　深度开发者计划 199
　　合作伙伴计划 199
　　Beta 计划 201
　　设计冲刺 203
　　广度开发者计划 204
　　聚会和社区活动 205
　　黑客马拉松206
　　在活动及活动赞助中发言 207
　　培训师和大使计划 207
　　在线视频和流媒体 208
　　支持、论坛和Stack Overflow 209
　　信用计划 209
　　测量开发者计划 210
　　小结 211
　　第11 章 总结 213
　　附录 API 设计工作表 215
　　作者介绍 221
　　封面介绍 221

　　Brenda Jin是一位企业家和软件工程师。作为Slack开发者平台团队的一名工程师，她的工作是为第三方开发者设计、构建和扩展API。作为Girl Develop It 的董事会成员和分会负责人，Brenda为众多开源教材做出了贡献，并使数千名女性有能力学习网络和软件开发。Saurabh Sahni是Slack开发者平台团队的一名工程师。在过去的八年中，他一直在构建和设计开发者平台和API。在Slack工作之前，Saurabh领导了一个负责Yahoo! 开发者网络基础架构和开发者工具的工程师团队，在那里他帮助推出了Yahoo! 移动开发者组件和一些API。Amir Shevat是Twitch的开发者经验副总裁。过去15年来，他一直在Slack、Microsoft和Google围绕API构建开发者产品、API和生态系统。他也是《Designing Bots》（O’Reilly）的作者。

　　·概述请求-响应和事件驱动的API设计范例。
　　·了解如何设计满足用户需求的API的*实践。
　　·使用模板创建API的设计过程。
　　·扩展API以支持不断增长的API调用和用例。
　　·根据产品和业务的变更定期调整API。
　　·为开发者提供相关资源，包括API文档、示例和工具。