RESTful Web APIs中文版PDF|Epub|txt|kindle电子书版本网盘下载

RESTful Web APIs中文版PDF格式电子书版下载

注意：本站所有压缩包均有解压码： 点击下载压缩包解压工具

第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

与众不同的Web14

Web API落后于Web15

语义挑战16

第2章 一个简单的API17

HTTP GET：安全的投注18

如何读取HTTP响应19

JSON20

Collection＋JSON21

向API写入数据23

HTTP POST：资源是如何生成的24

由约束带来解放26

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

第3章 资源和表述29

万物皆可为资源30

表述描述资源状态30

往来穿梭的表述31

资源有多重表述32

HTTP协议语义（Protocol Semantics）33

GET35

DELETE36

幂等性（Idempotence）36

POST-to-Append37

PUT38

PATCH39

LINK和UNLINK40

HEAD40

OPTIONS41

Overloaded POST41

应该使用哪些方法？42

第4章 超媒体45

将HTML作为超媒体格式46

URI模板49

URI vs URL50

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＋JSON94

子项的表示95

写入模板（WriteTemplate）98

搜索模板99

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

GET101

POST-to-Append101

PUT和PATCH101

DELETE102

分页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

Siren131

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

第8章 Profile135

客户端如何找寻文档？136

什么是Profile？137

链接到Proffle137

Proffle链接关系137

Profile媒体类型参数138

特殊用途的超媒体控件139

Proffle对协议语义的描述139

Proffle对应用语义的描述140

链接关系141

不安全的链接关系142

语义描述符142

XMDP：首个机器可读的Proffle格式143

ALPS146

ALPS的优势150

ALPS并不是万金油152

JSON-LD153

内嵌的文档156

总结158

第9章 API设计流程161

两个步骤的设计流程161

七步骤设计流程162

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

第2步：画状态图164

第3步：调整命名168

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

第5步：编写Profile173

第6步：实现174

第7步：发布174

实例：YouType It，We Post It177

罗列语义描述符177

画状态图178

调整名称179

选择一种媒体类型180

编Profile181

设计建议182

资源是实现的内部细节182

不要掉入集合陷阱183

不要从表述格式着手184

URL设计并不重要184

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

设计媒体类型187

当你的API改变时189

为现有API添加超媒体194

改进基于XML的API195

值不值得？196

Alice的第二次探险196

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

场景2：Profile198

Alice明白了200

第10章 超媒体动物园203

领域特定格式204

Maze＋XML204

OpenSearch205

问题细节文档205

SVG206

VoiceXML208

集合模式的格式210

Collection＋JSON211

Atom发布协议211

OData212

纯超媒体格式219

HTML219

HAL220

Link报头222

Location和Content-Location报头222

URL列表223

JSON主文档（Home Documents）223

Link-Template报头224

WADL225

XLink226

XForms227

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

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

GeoJSON没有媒体类型232

从GeoJSON学习到的经验233

语义动物园234

链接关系的IANA注册表234

微格式WiKi235

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

第11章 API中的HTTP241

新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

Pipelining251

避免更新丢失问题252

认证254

WWW-Authenticate报头和Authorization报头255

Basic认证255

OAuth 1.0256

OAuth 1.0的缺点259

OAuth 2.0260

何时不采用OAuth261

HTTP扩展261

PATCH方法262

LINK和UNLINK方法262

WebDAV263

HTTP 2.0264

第12章 资源描述和Linked Data267

RDF268

RDF将URL作为URI对待270

什么时候使用描述策略271

资源类型273

RDF Schema274

Linked Data运动277

JSON-LD278

将JSON-LD作为一种表述格式279

Hydra280

XRD家族285

XRD和JRD285

Web主机元数据文档286

WebFinger287

本体动物园（Ontology Zoo）289

schema.org RDF289

FOAF290

vocab.org290

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

第13章 GoAP：嵌入式系统的REST293

CoAP请求294

CoAP响应294

消息种类295

延迟响应（Delayed Response）296

多播消息（Multicast Message）296

CoRE Link Format297

结论：非HTTP协议的REST298

附录A 状态法典301

附录B HTTP报头法典325

附录C 为API设计者准备的Fielding论文导读349

词汇表365