目录
序 .1
前言 .3
第1 章 API 管理的挑战 9
1.1 什么是API 管理 11
1.1.1 API 业务 . 11
1.1.2 什么是API 13
1.1.3 不仅仅是API 15
1.1.4 API 的成熟度阶段 . 16
1.1.5 不止单个API 17
1.2 为什么API 管理如此之难 17
1.2.1 范围 18
1.2.2 规模 20
1.2.3 标准 20
1.3 管理API 格局 21
1.3.1 技术 22
1.3.2 团队 23
1.3.3 管治 24
1.4 小结 25
第2 章 API 管治 27
2.1 API 管治概述 . 28
2.1.1 决策 28
2.1.2 决策管理. 29
2.1.3 管治复杂的系统 . 30
2.2 决策的管治 . 33
2.2.1 集中式与分散式 . 34
2.2.2 决策元素. 40
2.2.3 决策映射. 46
2.2.4 实践中的决策设计 . 48
2.3 设计管治系统 49
2.3.1 管治模式1：设计权威 50
2.3.2 管治模式2：下放集中式专家组 52
2.3.3 管治模式3：受影响的自治 54
2.4 实施管治模式 55
2.4.1 不断改进解决方案 . 55
2.4.2 可观察性和可见性 . 57
2.4.3 运营模式. 57
2.4.4 为标准管理制定战略 58
2.5 小结 58
第3 章 API 即产品 60
3.1 可编程经济以API 为主导 61
3.2 设计思维 64
3.2.1 满足用户的需求 . 64
3.2.2 商业战略可行性 . 65
3.2.3 贝索斯命令 66
3.2.4 将设计思维应用到API 67
3.3 客户引导 69
3.3.1 惊喜时刻. 70
3.3.2 API 的客户引导 72
3.4 开发者体验 . 74
3.4.1 了解受众. 75
3.4.2 安全轻松地使用API 81
3.4.3 为什么开发人员在API 经济中如此重要 84
3.4.4 API 即产品（AaaP）的开发者关系 . 86
3.4.5 API 即产品的盈利与计价方式 . 96
3.5 小结 99
第4 章 API 产品的支柱 101
4.1 十大支柱简介 . 102
4.1.1 战略 103
4.1.2 设计 106
4.1.3 文档 111
4.1.4 开发 114
4.1.5 测试 117
4.1.6 部署 121
4.1.7 安全 124
4.1.8 监控 129
4.1.9 发现 131
4.1.10 变更管理 133
4.2 结合API 的各大支柱 135
4.2.1 将支柱应用到计划中 . 135
4.2.2 创建API 所需的四大支柱 138
4.2.3 API 运维的几大支柱 142
4.3 小结 . 146
第5 章 API 的持续改进 147
5.1 持续管理变更 . 148
5.1.1 增量式改进 . 149
5.1.2 API 变更的速度 154
5.2 API 的变更 156
5.2.1 API 发布的生命周期 156
5.2.2 接口模型的变更 158
5.2.3 实施的变更 . 160
5.2.4 实例的变更 . 161
5.2.5 支持资产的变更 162
5.3 提高API 的可变性 162
5.3.1 API 变更的成本 163
5.3.2 机会成本 163
5.3.3 耦合成本 164
5.3.4 预先做大量设计 166
5.4 小结 . 167
第6 章 API 风格 168
6.1 API 是语言 169
6.2 五大API 风格 . 171
6.2.1 隧道风格 171
6.2.2 资源风格 173
6.2.3 超媒体风格 . 175
6.2.4 查询风格 177
6.2.5 基于事件的风格 178
6.2.6 如何选择API 的风格与技术 . 180
6.3 不要局限于某种API 风格 182
6.4 小结 . 183
第7 章 API 产品的生命周期 . 184
7.1 度量与里程碑 . 185
7.1.1 OKR 和KPI 186
7.1.2 定义API 的目标 187
7.1.3 找出可度量的结果 189
7.2 API 的产品生命周期 191
7.2.1 第一个阶段：创建 192
7.2.2 第二个阶段：发布 195
7.2.3 第三个阶段：实现 200
7.2.4 第四个阶段：维护 203
7.2.5 第五个阶段：退役 205
7.3 通过产品生命周期管理各个支柱 . 208
7.3.1 创建 209
7.3.2 发布 213
7.3.3 实现 217
7.3.4 维护 219
7.3.5 退役 220
7.4 小结 . 221
第8 章 API 团队 222
8.1 API 角色 224
8.1.1 业务角色 225
8.1.2 技术角色 227
8.2 API 团队 229
8.2.1 团队与API 成熟度 . 230
8.2.2 扩展团队 237
8.2.3 Spotify 的团队与角色 238
8.2.4 影响团队扩展的因素 . 240
8.3 文化与团队 242
8.3.1 康威定律 243
8.3.2 邓巴数 245
8.3.3 亚历山大的文化马赛克 247
8.3.4 支持实验 249
8.4 小结 . 251
第9 章 API 格局 253
9.1 API 考古 255
9.2 大规模的API 管理 257
9.2.1 平台原则 258
9.2.2 原则、协议与模式 260
9.2.3 API 格局的语言格局 262
9.2.4 API 的API 264
9.3 理解API 格局 . 266
9.4 API 格局的八个V. 267
9.4.1 多样性 268
9.4.2 术语 269
9.4.3 规模 274
9.4.4 速度 275
9.4.5 脆弱性 276
9.4.6 可见性 277
9.4.7 版本管理 278
9.4.8 波动性 280
9.5 小结 . 281
第10 章 API 格局之旅. 282
10.1 构建API 格局的指南 283
10.2 API 格局指南的生命周期 287
10.3 支持中心 . 288
10.4 成熟度与八个V 292
10.4.1 多样性 293
10.4.2 术语 . 295
10.4.3 规模 . 298
10.4.4 速度 . 300
10.4.5 脆弱性 302
10.4.6 可见性 305
10.4.7 版本 . 307
10.4.8 波动性 309
10.5 小结 311
第11 章 持续发展格局中API 生命周期的管理 312
11.1 在实践中管理不断发展的格局 313
11.1.1 确立“红线” . 313
11.1.2 平台重于项目 . 314
11.1.3 设计需要考虑到消费者、生产者和赞助者 315
11.1.4 测试、衡量并吸取经验 . 317
11.2 API 产品与生命周期支柱 318
11.2.1 API 格局 319
11.2.2 决策点与成熟度 . 319
11.3 格局的各个方面与API 生命周期支柱 . 320
11.3.1 战略 . 321
11.3.2 设计 . 324
11.3.3 文档 . 326
11.3.4 开发 . 330
11.3.5 测试 . 334
11.3.6 部署 . 339
11.3.7 安全 . 344
11.3.8 监控 . 347
11.3.9 发现 . 350
11.3.10 变更管理 . 354
11.4 小结 357
第12 章 持续的旅程 359
12.1 为将来做准备 361
12.2 从今天开始管理 361
鄂公网安备 42010302001612号 