API

Что такое API?

API (Application Programming Interface) — согласованный интерфейс, через который две программные системы могут взаимодействовать и обмениваться данными без необходимости знать внутреннюю реализацию друг друга. В современном облачном B2B-мире API реализуется как правило через REST (Representational State Transfer) или GraphQL поверх HTTPS, с данными в формате JSON.

Типичная анатомия вызова REST API:

• Метод — GET (чтение), POST (создание), PUT / PATCH (изменение), DELETE (удаление)
• Endpoint — URL, например https://api.modulario.eu/v1/invoices/12345
• Аутентификация — как правило, Bearer-токен (OAuth 2.0) или API-ключ в заголовке
• Тело — JSON-payload при POST/PUT
• Ответ — HTTP-статус код + JSON-ответ

Хорошо спроектированный API имеет:

• Версионирование (/v1/, /v2/) — для обратной совместимости
• Rate limiting — ограничение количества вызовов в минуту/час
• Идемпотентность — повторный вызов с тем же ID не создаёт дублирование
• Обработку ошибок — предсказуемые структуры ошибок
• Пагинацию — при больших наборах данных

В B2B-контексте API позволяет, например, подключить интернет-магазин (WooCommerce, Shopify) к ERP — заказ из магазина автоматически создаётся в ERP через API, складские остатки синхронизируются обратно на сайт через API.

Когда применяется

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

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

• Webhook — push-уведомление от API. См. /ru/glossariy/webhook.
• SaaS — API является стандартным интерфейсом SaaS. См. /ru/glossariy/saas.
• MCP — слой, дружественный к ИИ, поверх API. См. /ru/glossariy/mcp.
• Workflow automation — использует API для связи систем. См. /ru/glossariy/workflow-automation.

В Modulario

Modulario предоставляет полное REST API для каждого модуля — аутентификация через OAuth 2.0 и API-ключи, rate limiting, идемпотентность. Документация, примеры и коллекции Postman доступны на /api.

Modulario API имеет публичную спецификацию OpenAPI 3.1, автоматически генерируемых клиентов для Python, TypeScript, PHP и Java, среду sandbox для тестирования и подробные примеры для типичных сценариев (создание счёта, синхронизация клиентов, загрузка отчёта).