Какво е REST API?

REST API е архитектурен стил, а не стандарт, за изграждане на разпределени системи. Той се основава на принципи като безсъстояние (statelessness), клиент-сървър архитектура и използване на стандартни HTTP методи (GET, POST, PUT, DELETE, PATCH) за операции върху ресурси.

Ключови принципи на REST:

• Безсъстояние (stateless): Сървърът не съхранява информация за състоянието на клиента между заявките. Всяка заявка съдържа цялата необходима информация за обработка.
• Клиент-сървър: Ясно разделение между клиента и сървъра. Всеки може да се развива независимо.
• Кешируемост: Отговорите могат да бъдат маркирани като кешируеми или не, което подобрява производителността.
• Многослойна система: Клиентът не може да знае дали е свързан директно със сървъра или чрез междинни слоеве.
• Единен интерфейс: Стандартизирани начини за взаимодействие с ресурсите. Включва:
  • Идентификация на ресурси (URI)
  • Манипулация на ресурси чрез представяне
  • Самоописващи се съобщения
  • Hypermedia като двигател на състоянието на приложението (HATEOAS) - състоянието на приложението се управлява чрез хипервръзки.

Пример за използване на стандартни HTTP методи:

Метод HTTP	Действие върху ресурса (например, /users)	Описание
GET	/users или /users/{id}	Получаване на списък с потребители или конкретен потребител.
POST	/users	Създаване на нов потребител.
PUT	/users/{id}	Пълно обновяване на данните на потребителя по неговия ID.
PATCH	/users/{id}	Частично обновяване на данните на потребителя по неговия ID.
DELETE	/users/{id}	Изтриване на потребител по неговия ID.

REST API се използва за взаимодействие между различни системи и приложения, например, между фронтенд и бекенд.