Что такое API: как приложения обмениваются данными

API — это договор между программами. Он определяет, куда отправлять запрос, какие данные передавать и какой ответ можно получить. Благодаря API сайт, мобильное приложение, платёжный сервис и внутренняя система компании могут обмениваться информацией, не зная внутреннее устройство друг друга.

Зачем сервисам нужен общий язык

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

Для backend-разработчика API часто становится главным результатом работы. Он создаёт не экран для пользователя, а способ, которым другие программы могут получить данные, выполнить действие и корректно обработать ошибку.

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

Что входит в API-контракт

У веб-API есть адреса, HTTP-методы, формат входных данных и формат ответа. Чаще всего данные передают в JSON: клиент отправляет объект с полями, сервер возвращает другой объект или список. Хороший API описывает не только успешный сценарий, но и то, что произойдёт при неверных данных или отсутствии прав доступа.

Клиенту не нужно знать, на каком языке написан сервер или в каких таблицах лежат записи. Ему важно понимать правила обращения к сервису — именно это и называют контрактом API.

Документация становится важной частью такого контракта. В ней обычно указывают адрес запроса, метод, обязательные поля, примеры ответа и возможные ошибки. Умение читать такую документацию полезно даже до того, как ты начнёшь писать собственный backend: оно учит видеть, как разные части приложения договариваются между собой.

Небольшой пример

GET /users/42/tasks HTTP/1.1
Host: api.example.com
Accept: application/json

HTTP/1.1 200 OK
Content-Type: application/json

{
  "user_id": 42,
  "tasks": [
    {"id": 1, "title": "Оплатить заказ", "done": false}
  ]
}

Клиенту достаточно знать, что по этому пути он получит список задач и какие поля будут у каждой записи. Как сервер ищет данные или проверяет права, остаётся внутри сервиса.

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

Что почитать дальше

• Что такое HTTP — транспорт для большинства веб-API.
• Что такое REST API — один из подходов к организации API.
• Словари в Python — как данные API представляются в коде.

API становится понятным, когда ты начинаешь видеть за каждым запросом конкретную задачу и ожидаемый ответ. В курсе «REST API: основы» можно пройти этот путь последовательно и закрепить его практикой.