Что такое API простыми словами?

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

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

На API держится почти любой современный сервис. Оплата картой на сайте — это обращение к API платёжной системы, карта на странице контактов — к API карт, курс валют в приложении — к API банка. Фронтенд общается с собственным бэкендом тоже через API.

Пример

Приложение доставки запрашивает у API ресторана список блюд, отправляет заказ и получает статус — всё это отдельные вызовы одного API.

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

REST API

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

JSON

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

Webhook

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

Backend

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

Function Calling

Function calling (он же tool calling) — это механизм, который позволяет языковой модели вызывать внешние функции. Разработчик описывает доступные функции и их параметры, а модель, когда это нужно, возвращает не текст, а структурированный запрос: какую функцию вызвать и с какими аргументами.

MCP

MCP (Model Context Protocol) — это открытый протокол, который стандартизирует подключение AI-приложений к внешним инструментам и источникам данных. Он описывает единый способ, которым модель узнаёт, какие инструменты доступны, и вызывает их.