RESTful API设计技巧经验总结(3)_H5之家 - 中国HTML5教程资源分享第一站

如果每页20个结果之外还有其他的结果，谷歌的Places API就会在响应中返回next_page_token。然后，服务器在新的请求中接收到这个令牌后，就会返回更多的结果，并附带新的next_page_token，直到所有的结果全部都返回给客户端。

Twitter使用参数next_cursor实现了类似的功能。

实现“健康检查”URL

很有必要提供一种方法来输出一个简单的响应，以此来表明API实例是活着的，不需要重新启动。这个功能也很有用，通过它可以很方便地检查某个时间点的某台服务器上的API是什么版本，而这无需通过认证。

GET /v1 // response - HTTP 200 { "status": "running", "version": "fdb1d5e" }

我提供了 status 和 version 这两个值。另外值得一提的是，这个值是从 version.txt 文件读取到的，如果读取错误或者文件不存在，则默认值为 __UNKNOWN__ 。

查看原文： RESTful API设计技巧经验总结