URL 的理解

维基百科给出答案

URL（全名Uniform Resource Locator），又譯劃一資源定位器，俗稱網頁地址（網址），係互聯網上標準嘅資源嘅地址。要去互聯網上任何一個地方，都需要佢嘅URL。

首先咱们要理解这个叫资源定位的意思，咱们平时在配置部署 web 服务器的时候，应该都有见过 document root 这个配置项，以 nginx 为例，nginx 中，就是需要配置一个 root 选项，而每个 server 都对应一个 server_name，或是域名，或是ip，一个标示，那这个 server_name 其实可以简单地把它看成是 root 的别名，当访问到这个 server_name 的时候，就会自动在 root 目录下进行查询。如：

server {
    server_name test.com
    root /htdocs
    # some config
}

当访问到 http://test.com 的时候，就会去到 /htdocs 目录下寻找目标。

http://test.com/a.html => /htdocs/a.html
http://test.com/public/a.html => /htdocs/public/a.html

这个是最基本的方法，当然你可以在 server 中配置其他，这里不再阐述。

其实说白了，他只是一个 “资源定位” 的作用。

很明显地，其实这里寻找的是 html 文件，也可以寻找 json，xml 文件，如：

http://test.com/a.json => /htdocs/a.json
http://test.com/public/a.xml => /htdocs/public/a.xml

其实都是一样，只要理解了 “资源定位”，那么其实，URL 就是访问一个文件内容，至于这个 “文件” 内部怎么执行，就需要自己定义了。

Http Api 设计

那么既然理解了上述的 URL 的意义，那么设计 API 起来就很好做了，所谓的 RESTful API 设计，其实我的理解无非就是让你清楚 URL 的作用，然后对应地给不同的 “文件” 进行操作。

1. 文章的获取：

Host: http://test.com

1.1 文章列表

http://test.com/articles/{page}

http://test.com/articles/1
http://test.com/articles/2

1.2 文章详情

http://test.com/articles/{page}/{id}.{format}

http://test.com/articles/1/3.html
http://test.com/articles/2/12.json

以上理解为：

http://test.com/articles/1/3.html 这个地址定位到: /htdocs/articles/1/3.html
http://test.com/articles/2/12.json 这个地址定位到: /htdocs/articles/2/12.json

此处有一个 format 用于决定响应的资源类型。需要考虑下吧，都定义为 json 就好了。

分页设计(优化版)

设计一个文章列表，可分页查询，可以查询文章详情。

http://test.com/articles/{id}?page={page}&limit={limit}

如果存在文章 id 详情信息，则返回指定的文章详情。若非查询制定的文章内容，则显示分页的文章信息。

分页请求:

http://test.com/articles/?page={page}&limit={limit}
// or 
http://test.com/articles?page={page}&limit={limit}

第一种更为合理，因为该资源是一个 "目录"，请理解 "根" 的概念。

内容请求:

http://test.com/articles/1

可以可以，这样就完成了请求的样例。

很好理解吧，这样设计出来的 API 其实可以收是一目了然。在资源后缀上，是可以自己定义的，如 FastD 中就有此项功能，可以根据不同后缀返回不同的内容格式。

以上仅是个人理解及想法，欢迎指点与批评。