API

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

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