Что такое API

Интерфейс прикладного программирования (API - Application Programming Interface) — это набор правил и точек взаимодействия, через которые одна программа может использовать функции или данные другой программы. В контексте веб-разработки и мобильных приложений под API обычно понимают веб-API: совокупность URL-адресов (эндпоинтов), к которым клиент может отправлять HTTP-запросы для получения или изменения данных.

Веб-API работает по принципу «запрос — ответ». Клиент (приложение) отправляет запрос на определённый адрес, указывая метод (GET, POST и т.д.), заголовки и, при необходимости, тело запроса. Сервер обрабатывает этот запрос и возвращает ответ — как правило, в формате JSON.

Примеры типичных эндпоинтов:

GET /api/users — получить список пользователей
POST /api/login — отправить учётные данные для входа
PUT /api/profile — обновить профиль пользователя

Большинство современных веб-API следуют стилю проектирования REST (Representational State Transfer). REST не является протоколом, а скорее набором рекомендаций: использование стандартных HTTP-методов, отсутствие состояния между запросами, ресурсно-ориентированная структура URL. Хотя в этой теме мы не углубляемся в REST, важно понимать, что большинство API, с которыми вы будете работать, будут REST-подобными.

В мобильных и веб приложениях API особенно важен, потому что само приложение не хранит данные локально в полном объёме. Вместо этого оно запрашивает их у сервера через API, отображает пользователю и отправляет обратно изменения. Это позволяет синхронизировать данные между устройствами и централизованно управлять бизнес-логикой.

Основные характеристики веб-API

Работает поверх HTTP/HTTPS
Использует стандартные методы: GET (чтение), POST (создание), PUT/PATCH (обновление), DELETE (удаление)
Обычно возвращает данные в формате JSON
Требует аутентификации (часто через заголовок Authorization)
Документируется (например, с помощью Swagger или Postman)

Но, помимо классического HTTP(S)-API, существуют и другие виды API.