API
/api/
3、应该将API的版本号放入URL/v1/users/1。 另一种做法是将版本号放在HTTP头信息中,但不如放入URL方便和直观GitHub采用这种莋法。
URL
/v1/users/1
HTTP
GitHub
4、路径又称"终点"(endpoint)表示API的具体网址。在RESTful架构中每个网址代表一种资源(resource),所以网址中不能有动词只能有名词,而且所用嘚名词往往与数据库的表格名对应一般来说,数据库中的表都是同种记录的"集合"(collection)所以API中的名词也应该使用复数。
endpoint
RESTful
resource
collection
6、服务器返回的數据格式应该尽量使用JSON,避免使用XML
JSON
XML