REST, всі про нього знають, але зазвичай на рівні того, що ресурси треба описувати в множині, використовуючи сегменти URL. І так, це теж важливо, але основні концепції дизайну REST API значно глибші.

Щоб не роздувати пост до космічних масштабів, я коротко опишу основні моменти, а хто захоче розібратись, знайде детальніше в інтернетах:

Семантика HTTP
На ній заснований REST тому розуміння семантики є ключовою темою в дизайні. Тут все просто, разом з AI розбираєте сенс HTTP методів, статус кодів, заголовків, а також query i path параметрів.

Ідемпотентність
Це також частина семантики, але вона на стільки важлива, що я виділив її окремо. В контексті REST потрібно розуміти, які HTTP методи повинні бути ідемпотентні, а які ні.

Про ідемпотентність планував окремий пост, так як це одна з ключових концепцій розподілених систем і буде доречно висвітлити її в контексті мікросервісів.

Statelesness
Відсутність стану - це важливий технічний аспект, який має реалізовувати система при використанні REST. Ваш backend не повинен нічого знати про frontend, а вся потрібна інформація про клієнта, має міститись в запиті.