Что такое REST API?

REST API — самый распространённый стиль построения веб-API, в котором каждый объект системы доступен по своему адресу, а действие над ним задаётся HTTP-методом: GET — получить, POST — создать, PUT — изменить, DELETE — удалить.

Адрес описывает ресурс, метод — операцию. Запрос GET /users/42 возвращает данные пользователя, DELETE /users/42 удаляет его. Ответ содержит данные — обычно в формате JSON — и код статуса: 200 при успехе, 404 если объекта нет, 401 при отсутствии авторизации.

Ещё одно важное свойство REST — отсутствие состояния: каждый запрос самодостаточен и содержит всё нужное, включая токен авторизации. Сервер не помнит предыдущий запрос, что упрощает масштабирование.

Связанные термины

API

API (Application Programming Interface) — это набор правил, по которым одна программа обращается к другой: какие запросы можно отправить, какие параметры передать и в каком виде придёт ответ. API позволяет использовать чужой сервис, ничего не зная о его внутреннем устройстве.

JSON

JSON (JavaScript Object Notation) — текстовый формат обмена данными, в котором информация записывается парами «ключ — значение». Его понимают все языки программирования, и именно в нём чаще всего отвечают современные API.

Webhook

Вебхук — это способ получать уведомления о событиях: вы указываете сервису адрес, и как только происходит событие, он сам отправляет на этот адрес HTTP-запрос с данными. Не вы спрашиваете «есть новости?», а вам сообщают, когда новость появилась.

Backend

Backend — серверная часть приложения: она хранит и обрабатывает данные, содержит бизнес-логику, отвечает за авторизацию и безопасность и отдаёт результат фронтенду через API. Пользователь её не видит, но именно она определяет, что приложение умеет.

API Testing

Тестирование API — проверка серверных методов напрямую, без интерфейса: тестировщик отправляет запрос с определёнными параметрами и сверяет ответ — данные, структуру, код статуса и время обработки.