Системный анализ | Ольга Пономарева

Основные ошибки описания REST API



1️⃣ Конечные точки в URL – имя существительное, не глагол

Как не надо: /getFarmers

Как рекомендуется: /farmers



2️⃣ Множественное число

Как не надо: /farmer или /farmer/{farmer_id}

Как рекомендуется: /farmers или /farmers/{farmer_id}



3️⃣ HTTP методы

Помнить, что бывают идемпотентные и неидемпотентные методы



Больше ошибок в статье тут