- 一個URI對應(yīng)的是一個Logical Resource,盡量使用名詞而不是動詞
- 統(tǒng)一使用復(fù)數(shù)
- 使用標(biāo)準(zhǔn)的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
- 使用標(biāo)準(zhǔn)的HTTP Response Code
- 通過URL來控制版本,而不是HTTP Header
- 對于時間序列,可以用Before/After類型的分頁