RESTFUL WEB API模式和实践经典实例

本书的主要内容有：设计与构建可在开放网络上成功交互的服务接口。通过共享语义来提高API的互操作性。构建可适应服务演进而不致崩溃的客户端应用。创建支持点对点交互的弹性且可靠的API。使用基于Web的API注册中心，实现运行时的“发现与绑定” 机制，从而实时管理外部依赖。实施稳定的工作流，确保复杂的多服务任务可以一致地执行。

Mike Amundsen是国际知名的作家与演讲者，长期活跃于网络架构、Web开发及技术与社会交叉领域的研究与咨询工作。

目录
序 1
前言 3
第一部分 理解RESTful 超媒体
第1 章 RESTful Web API 介绍 17
1.1 RESTful Web API 是什么 .18
1.2 为何选择超媒体 24
1.3 Web 可扩展服务的共享原则 32
第2 章 用超媒体思维进行思考与设计 37
2.1 使用超媒体设计奠定基础 39
2.2 使用超媒体客户端提升弹性 44
2.3 使用超媒体服务提升稳定与可修改性 52
2.4 支持分布式数据 59
2.5 使用超媒体工作流提高可扩展性 .65
第二部分 超媒体技巧手册
第3 章 超媒体设计 75
3.1 通过注册媒体类型实现互操作性 .77
3.2 通过结构化媒体类型确保未来兼容性 79
3.3 通过发布词汇表实现领域特性的共享 82
3.4 通过语义配置文件描述问题空间 .86
3.5 通过嵌入式超媒体在运行时表达操作 91
3.6 通过幂等操作设计一致的数据写入.95
3.7 通过服务间状态转移实现互操作性.98
3.8 设计可重复的操作 .103
3.9 设计可撤销的操作 .106
3.10 设计可扩展的消息 111
3.11 设计可修改的接口 115
第4 章 超媒体客户端 . 121
4.1 限制硬编码URL 的使用 123
4.2 让客户端具备HTTP 感知能力 128
4.3 通过以消息为中心的实现编写有弹性的客户端 .131
4.4 编写能理解词汇表配置文件的有效客户端 134
4.5 在运行时协商配置文件支持 .138
4.6 在运行时管理表述格式 141
4.7 使用模式文档作为消息元数据的来源 .146
4.8 响应中的每个重要元素都需要标识符 .151
4.9 依赖响应中的超媒体控件 .155
4.10 为非超媒体服务支持链接和表单 159
4.11 在运行时验证数据属性 163
4.12 使用文档模式验证出站消息 166
4.13 使用文档查询验证入站消息 173
4.14 验证传入数据 176
4.15 维护自身状态 180
4.16 心怀目标 183
第5 章 超媒体服务 . 191
5.1 至少发布一个稳定的URL .193
5.2 防止内部模型泄漏 .196
5.3 将内部模型转换为外部消息 .200
5.4 将内部功能表达为外部操作 .206
5.5 声明对客户端响应偏好的支持 211
5.6 支持HTTP 内容协商 217
5.7 为机器客户端发布完整的词汇表 221
5.8 以标准格式支持共享词汇表 .229
5.9 发布服务定义文档 .235
5.10 发布API 元数据 239
5.11 支持服务健康监测 245
5.12 标准化错误报告 251
5.13 通过运行时服务注册表提升服务可发现性 255
5.14 通过客户端提供的标识符提高吞吐量 260
5.15 通过幂等创建提升可靠性265
5.16 为依赖服务提供运行时回退策略 269
5.17 使用语义代理访问不合规服务 .275
第6 章 分布式数据 . 283
6.1 隐藏数据存储内部实现 285
6.2 让所有变更具备幂等性 290
6.3 对外部操作隐藏内部数据关系 296
6.4 利用HTTP URL 支持“包含”和“与”查询 .300
6.5 返回查询响应的元数据 304
6.6 以数据为中心的查询：是返回HTTP 200 还是HTTP 400 310
6.7 使用媒体类型进行数据查询 .316
6.8 忽略未知数据字段 .322
6.9 通过缓存指令提升性能 327
6.10 在生产环境中修改数据模型 334
6.11 扩展远程数据存储 341
6.12 限制过大的响应 346
6.13 使用透传代理进行数据交换 351
第7 章 超媒体工作流 . 361
7.1 设计符合工作流规范的服务 .363
7.2 支持工作流的状态共享 368
7.3 以代码形式描述工作流 372
7.4 以DSL 描述工作流 376
7.5 以文档形式描述工作流 378
7.6 支持RESTful 作业控制语言 382
7.7 为工作流暴露进度资源 387
7.8 返回所有相关操作 .391
7.9 返回最近使用的资源 396
7.10 支持有状态的在制品 .401
7.11 启用标准列表导航 409
7.12 支持部分表单提交 414
7.13 使用状态监视实现客户端驱动的工作流 .418
7.14 通过存储的重放优化查询428
7.15 对未完成工作使用202 Accepted 进行同步回复 435
7.16 通过自动重试进行短期修复 442
7.17 支持本地撤销或回滚 .447
7.18 请求帮助 452
7.19 通过队列和集群扩展工作流 456
7.20 使用工作流代理整合非合规服务 459
第8 章 结束语 463
8.1 应用这些技巧 463
8.2 改造现有服务 466
8.3 其他资源.467
8.4 后续步骤.468
附录A RESTful Web API 指导原则 . 469
附录B 补充阅读 471
附录C 相关标准 475
附录D 使用HyperCLI 479