RESTful API路径设计指南


RESTful API Path design guideline

我想知道一个restful API,下面哪一个更实用?

  1. myapi.com/users/{userid}
  2. myapi.com/users?userid={userid}

我只是困惑于我们什么时候应该在URL中传递参数Param与Path。

参数用于过滤查询:

http://www.acme.com/products/?filter=cats&sort=des

和路径被用来获得一个元素:

http://www.acme.com/products/1234

因此,我建议您使用myapi.com/users/{userid}

跳到这篇精彩演示的幻灯片60(我建议您阅读)。