《RESTful Web APIs中文版》

《RESTful Web APIs中文版》

基本信息

原书名：RESTful Web APIs

原出版社： O'Reilly Media

作者： Leonard Richardson    Mike Amundsen

译者： 赵震一 李哲

出版社：电子工业出版社

ISBN：9787121231155

上架时间：2014-6-11

出版日期：2014 年6月

开本：16开

页码：382

版次：1-1

所属分类：计算机 > 计算机网络 > Web Server > WebServer

更多关于》》》《RESTful Web APIs中文版》

编辑推荐

近年来，REST的流行导致了各种“RESTful”API的巨大增长，但是这些API却错失了很多架构的好处。通过这本实用指南，你将可以学习到如何设计可用的，并能随着时间不断进化的REST API。通过专注于跨多种领域的解决方案，本书向你展示了该如何使用那些为世界上最成功的分布式计算系统——万维网而设计的工具，从而来 创建强大且安全的应用。你将探索REST背后的概念，学习多种可用于创建基于超媒体API的策略，并在本书一步步的指导下整合你所学到的所有内容，从而去设计RESTful的web API。

　　 √ 审查了包括集合模式和纯超媒体在内的API设计策略。

　　 √ 理解如何将超媒体与表述整合进一个一致的API。

　　 √ 探索XMDP和ALPS profile格式是如何帮助你应对web API的“语义挑战”的。

　　 √ 学习近二十多种标准化的超媒体数据格式。

　　 √ 应用在API实现中使用HTTP的最佳实践。

　　 √ 使用JSON-LD标准及其他Linked Data方法来创建web API。

　　 √ 理解在嵌入式系统使用REST的CoAP协议。

内容简介

书籍

计算机书籍

《restful web apis中文版》是针对restful api的实用指南，通过展示各种用来创建高可用应用的强大工具，讲解rest的深层原理，以及介绍基于超媒体api的策略，使读者得以在将上述内容融会贯通后，设计出让客户高度满意的restful的web api。《restful web apis中文版》极具权威性与前瞻性，既代表了api领域的最前沿趋势，也覆盖了api领域的最重要实践。

《restful web apis中文版》适合所有从事web开发和架构工作的读者阅读参考。

媒体评论

　　“这是一本了不起的书！《RESTful Web APIs》覆盖了当今API领域最重要的趋势和实践。”

　　——John Musser ProgrammableWeb创始人

作译者

Leonard Richardson， 《Ruby Cookbook》 （O’Reilly）一书的作者，曾 创建了包括Beautiful Soup在内 的多个开源代码库。Mike Amundsen 是包括《Building Hypermedia APIs with HTML5 and Node》（O’Reilly） 在内的十几本为人所称道的技术图书的作者。

Sam Ruby 是W3C HTML工作组的联合主席，同时也是IBM新 兴技术组的一名高级技术人员。

目录

《restful web apis中文版》

序 xix

前言 xxi

第1 章 网上冲浪 1

场景1 ：广告牌 2

资源和表述 2

可寻址性 3

场景2 ：主页 3

短会话（short session） 5

自描述消息（self-descriptive message） 5

场景3 ：链接 6

标准方法 8

场景4 ：表单和重定向 9

应用状态（application state） 11

资源状态（resource state） 12

连通性（connectedness） 13

与众不同的web 14

web api 落后于web 15

语义挑战 16

第2 章 一个简单的api 17

http get ：安全的投注 18

如何读取http 响应 19

json 20

collection+json 21

向api 写入数据 23

http post: 资源是如何生成的 24

由约束带来解放 26

应用语义所产生的语义鸿沟 27

第3 章 资源和表述 29

万物皆可为资源 30

表述描述资源状态 30

往来穿梭的表述 31

资源有多重表述 32

http 协议语义（protocol semantics） 33

get 35

delete 36

幂等性（idempotence） 36

post-to-append 37

put 38

patch 39

link 和unlink 40

head 40

options 41

overloaded post 41

应该使用哪些方法？ 42

第4 章 超媒体 45

将html 作为超媒体格式 46

uri 模板 49

uri vs url 50

link 报头 51

超媒体的作用 52

引导请求 52

对响应做出承诺 54

工作流控制 55

当心冒牌的超媒体！ 56

语义挑战：我们该怎么做？ 57

第5 章 领域特定设计 59

maze+xml ：领域特定设计 60

maze+xml 是如何工作的 61

链接关系 62

访问链接来改变应用状态 64

迷宫集合 65

maze+xml 是api 吗？ 67

客户端1 ：游戏 68

maze+xml 服务器 72

客户端2 ：地图生成器 74

客户端3 ：吹牛者 76

客户端做自己想要做的事 77

对标准进行扩展 77

地图生成器的缺陷 80

修复（以及修复后的瑕疵） 81

迷宫的暗喻 83

解决语义鸿沟 83

领域特定设计在哪里？ 83

最终的奖赏 84

报头中的超媒体 84

抄袭应用语义 84

如果找不到相关的领域特定设计，不要自己制造 86

api 客户端的种类 86

人类驱动的客户端 86

自动化客户端 87

第6 章 集合模式（collection pattern） 91

什么是集合？ 93

链向子项的集合 93

collection+json 94

子项的表示 95

写入模板（write template） 98

搜索模板 99

一个（通用的）集合是如何工作的 100

get 101

post-to-append 101

put 和patch 101

delete 102

分页 102

搜索表单 103

atom 发布协议（atompub） 103

atompub 插件标准 105

为什么不是每个人都选择使用atompub ？ 106

语义挑战：我们应该怎么做？ 107

第7 章 纯- 超媒体设计 111

为什么是html? 111

html 的能力 112

超媒体控件 112

应用语义插件 113

微格式 115

hmaze 微格式 116

微数据 118

改变资源状态 119

为表单添加应用语义 121

与超媒体相对是普通媒体 125

html 的局限性 126

拯救者html5? 127

超文本应用语言 128

siren 131

语义挑战：我们现在要怎么做？ 133

第8 章 profile 135

客户端如何找寻文档？ 136

什么是profile ？ 137

链接到profile 137

profile 链接关系 137

profile 媒体类型参数 138

特殊用途的超媒体控件 139

profile 对协议语义的描述 139

profile 对应用语义的描述 140

链接关系 141

不安全的链接关系 142

语义描述符 142

xmdp ：首个机器可读的profile 格式 143

alps 146

alps 的优势 150

alps 并不是万金油 152

json-ld 153

内嵌的文档 156

总结 158

第9 章 api 设计流程 161

两个步骤的设计流程 161

七步骤设计流程 162

第1 步：罗列语义描述符 163

第2 步：画状态图 164

第3 步：调整命名 168

第4 步：选择一种媒体类型 172

第5 步：编写profile 173

第6 步：实现 174

第7 步：发布 174

实例：you type it, we post it 177

罗列语义描述符 177

画状态图 178

调整名称 179

选择一种媒体类型 180

编写profile 181

设计建议 182

资源是实现的内部细节 182

不要掉入集合陷阱 183

不要从表述格式着手 184

url 设计并不重要 184

标准名称优于自定义名称 186

设计媒体类型 187

当你的api 改变时 189

为现有api 添加超媒体 194

改进基于xml 的api 195

值不值得？ 196

alice 的第二次探险 196

场景1 ：没有意义的表述 196

场景2 ：profile 198

alice 明白了 200

第10 章 超媒体动物园 203

领域特定格式 204

maze+xml 204

opensearch 205

问题细节文档 205

svg 206

voicexml 208

集合模式的格式 210

collection+json 211

atom 发布协议 211

odata 212

纯超媒体格式 219

html 219

hal 220

link 报头 222

location 和content-location 报头 222

url 列表 223

json 主文档（home documents） 223

link-template 报头 224

wadl 225

xlink 226

xforms 227

geojson ：一个令人困惑的类型 228

geojson 没有通用的超媒体控件 230

geojson 没有媒体类型 232

从geojson 学习到的经验 233

语义动物园 234

链接关系的iana 注册表 234

微格式wiki 235

来自微格式wiki 的链接关系 236

第11 章 api 中的http 241

新http/1.1 规范 242

响应码 242

报头 243

表述选择 243

内容协商（content negotiation） 243

超媒体菜单 244

标准url（canonical url） 245

http 性能 246

缓存（caching） 246

条件get 请求（conditional get） 247

look-before-you-leap 请求 249

压缩 250

部分get 请求（partial get） 250

pipelining 251

避免更新丢失问题 252

认证 254

www-authenticate 报头和authorization 报头 255

basic 认证 255

oauth 1.0 256

oauth 1.0 的缺点 259

oauth 2.0 260

何时不采用oauth 261

http 扩展 261

patch 方法 262

link 和unlink 方法 262

webdav 263

http 2.0 264

第12 章 资源描述和linked data 267

rdf 268

rdf 将url 作为uri 对待 270

什么时候使用描述策略 271

资源类型 273

rdf schema 274

linked data 运动 277

json-ld 278

将json-ld 作为一种表述格式 279

hydra 280

xrd 家族 285

xrd 和jrd 285

web 主机元数据文档 286

webfinger 287

本体动物园（ontology zoo） 289

schema.org rdf 289

foaf 290

vocab.org 290

总结：描述策略生机盎然！ 290

第13 章 coap: 嵌入式系统的rest 293

coap 请求 294

coap 响应 294

消息种类 295

延迟响应（delayed response） 296

多播消息（multicast message） 296

core link format 297

结论：非http 协议的rest 298

附录a 状态法典 301

附录b http 报头法典 325

附录c 为api 设计者准备的fielding 论文导读 349

词汇表 365

本图书信息来源:互动出版网