Хороший REST API строится на URL-адресах, ориентированных на ресурсы (/users/42/orders), правильных HTTP-методах (GET, POST, PUT, DELETE) и осмысленных кодах статуса (200, 201, 404, 422). Версионирование (/api/v1/) позволяет вносить изменения без поломки старых клиентов.
Ответы об ошибках всегда должны иметь единый формат: {"error": "...", "details": [...]}. Для пагинации используется page и per_page или подход на основе курсора. Rate limiting защищает API от злоупотреблений.
Наши курсы по этой теме