Начинаю серию постов “IT штуки аллегориями».

Первым на очереди REST API.

REST API — это удобный способ для разных приложений обмениваться данными и выполнять операции, используя веб-технологии. В основном он используется для обмена данными между клиентом (например, веб-приложением или мобильным приложением) и сервером.

Предположим, у нас есть мозг как сервер. Ему как-то надо общаться с внешним миром. Вот способом общения мозга с внешним миром будет REST API. Есть стандартно 4 операции CRUD. Create, Read, Update, Delete. В REST API это POST, GET, PUT, DELETE.

Давайте запилим для мозга операцию записи чего-то в мозг. Это будет метод POST. Закодим уши и будем в эти уши лить всякое. По айтишному это будет «вызывать метод POST [название метода], обращаясь на ендпоинт. Метод POST «уши» воспринимает только звуковую информацию, поэтому, если в уши показать картинку, то, понятное дело, будет ошибка. Об этой ошибке, или об успешно принятом вызове надо сообщить. Поэтому запилим «рот» как базовую функцию ответа на любые вызовы.

Рот может отвечать, что все принял (200, ОК), или выдавать ошибку (например, 400), если с вызовом что-то не так.

Давайте на примере: Вызовем метод POST “Уши” и скажем в них: «Данила — красавчик». Рот ответит: «Принято».

Отлично, с методом POST мы справились и теперь мозг знает, что Данила — красавчик. Спустя время вы забыли кто красавчик и хотите это узнать.

Чтобы что-то узнать у мозга, нужно дать задание выдать информацию. За это отвечает метод GET.

Метод GET обязательно должен иметь какие-то параметры, чтобы мозг понял что конкретно вы от него хотите. Поэтому, вызывая метод GET “Уши” вы говорите, например, «красавчики», и рот отвечает вам список всех имен, кто в мозгу записан как «красавчик». Или можете спросить: «Данила». И рот (сервер) ответит вам «красавчик».

Таким образом мы разобрали методы POST и GET REST API, я вернусь к вам с новой жизненной аллегорией.