Restful起源及设计理念

API:

就是一些预先定义好的函数，目的是能够让应用程序或开发人员能具有访问网络资源的能力，而又无需关心访问的源码，或是裂解内部工作机制的细节。

Restful API规范

1、协议

renst api 与用户的通信协议，总是使用HHTTP协议

2、域名

应该尽量将api部署在专用的域名之下
https://api.example.com

如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。
https://example.com/api/

3、版本

应该将API的版本号放入URL
https://api.example.com/version/

另一种做法是将版本号放在HTTP头信息中但不如放在URL方便和直观

4、路径

路径又称重点，表示API的具体网址。

在RESTful架构中每个网址代表一种资源，所以网址中不能有动词，只能由名词，而且所用的名词往往与数据库的表明对应。一般来说，数据库中的表都是同种记录的“集合”，所以API中的名词也应该是复数。

example：
有一个API提供动物园（zoo）的信息，还包括各种动物和雇员信息，则它的路径应该设计成下面这样。
https://api.example.com/v1/zoos
https://api.example.com/v1/animals
https://api.example.com/v1/employees

5、HTTP动词

post（create） delete（delete） put（update） get（select）

6、过滤信息

如果记录数量很多，APi应该提供参数，过滤返回结果。
?limit=10:指定返回记录的数量
?offset=10:指定返回记录的开始位置
?page=2&per_page=100：指定第几页，以及每页的记录数
?sortby=name&order=asc:指定返回结果按照那个属性排序，以及排序顺序
?animal_type_id=1:指定筛选条件

7、状态码

200
201

204

401

403

404

406

8、错误处理

{
error：“Invalid API key”
}

HTTP协议：

http的重要性：
web service Http+xml
rest大型架构 http+json/xml
各种api
采集、挖矿
Ajax

rest是Http驱动的，别切完全发挥HTTP的能力

HTTP是什么：
一种web常见应用层的网络协议，全程为：超文本传输协议
作为协议：http仅仅是将通信过程