Design API REST

Conventions URL

• Ressources au pluriel: /users, /orders
• IDs dans le chemin: /users/{id}
• Relations imbriquées: /users/{id}/orders
• Actions non-CRUD avec verbes: /orders/{id}/cancel

Codes HTTP

Structure Réponse

{
  "data": {},
  "meta": { "page": 1, "total": 100 },
  "errors": [{ "code": "E001", "message": "" }]
}

Pagination

GET /users?page=2&limit=20
GET /users?cursor=abc123&limit=20