HTTP Restful API

- 一个URI对应的是一个Logical Resource，尽量使用名词而不是动词

- 统一使用复数

- 使用标准的HTTP Method

    - - GET /tickets - Retrieves a list of tickets

    - - GET /tickets/12 - Retrieves a specific ticket

    - - POST /tickets - Creates a new ticket

    - - PUT /tickets/12 - Updates ticket #12

    - - PATCH /tickets/12 - Partially updates ticket #12

    - - DELETE /tickets/12 - Deletes ticket #12

- 使用query parameter for filtering, sorting & searching

- 使用标准的HTTP Response Code

- 通过URL来控制版本，而不是HTTP Header

- 对于时间序列，可以用Before/After类型的分页