← Назад в словарь

API

API (Application Programming Interface) — интерфейс программирования приложений

Суть в одном предложении

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

Краткое определение

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

Оригинал и перевод

  • Язык: английский
  • Оригинал: Application Programming Interface
  • Буквальный перевод: интерфейс программирования приложений

Синонимы и варианты написания

  • Интерфейс программирования
  • Программный интерфейс
  • Web API (в контексте HTTP)

Происхождение

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

Где используется

  • Веб-разработка (REST API, GraphQL)
  • Мобильные приложения
  • Интеграции между сервисами
  • Микросервисная архитектура
  • Плагины и расширения CMS
  • Работа с внешними сервисами (платёжные шлюзы, CRM, почтовые сервисы)

Когда это важно

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

Подробное объяснение

API определяет:

  1. Какие методы доступны (например: GET /users)
  2. Какие данные передаются
  3. В каком формате (JSON, XML, protobuf)
  4. Какие коды ответа возвращаются (200, 404, 500)

Главное — API это контракт.
Клиенту не важно, как устроен сервер.
Важно, что контракт стабилен.

Пример HTTP API запроса:

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

Ответ:

{
  "id": 42,
  "name": "Ivan",
  "role": "admin"
}

Клиенту всё равно, используется ли внутри Laravel, WordPress, Bitrix или Go. Он работает по контракту.

Основные виды API

  • Web API (HTTP)
  • REST API
  • GraphQL API
  • RPC
  • Internal API (межмодульный)
  • Public API (внешний)

Что не является API

  • HTML-страница для пользователя
  • Доступ к базе напрямую
  • Внутренний приватный метод без публичного контракта

Аналоги и связанные термины

  • REST API
  • Endpoint
  • Contract
  • Microservices
  • Middleware

Пример использования

«Наш мобильный клиент общается с сервером через REST API и получает данные в формате JSON.»

Мини-FAQ

  • API и REST API — это одно и то же? Нет. REST — это архитектурный стиль реализации Web API.

  • Можно ли считать базу данных API? Нет. База — это источник данных. API — это интерфейс доступа к логике.

Смотри также

  • REST API
  • Endpoint
  • Microservices
  • DTO