API 2.2 - Общая информация

Общая информация 

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

У Finmap открытый API, который могут использовать юзеры для собственных нужд и настройки индивидуальных интеграций с сервисом. Просмотреть информацию по API можно в разделе Настройки - Настройки компании, блок - Разработчикам. Здесь вы найдете информацию об АРІ-документации.
📎 Или же можете найти ее по этой ссылке: https://api.finmap.online/

💡 Если ваша цель — подключить Finmap к AI-помощнику (Claude, ChatGPT и т.п.), а не строить собственную интеграцию, воспользуйтесь MCP: Подключение Finmap к AI-помощнику (MCP).

Ключ API – это ключ шифрования для аутентификации пользователя в системе, по аналогии логина и пароля.
API-документация Finmap создана на базе ресурса Swagger

Блоки в АРІ-документации 

Документация разделена на блоки:

• webhooks - блок который помогает работать с вебхуками
• default - общая проверка на работоспособность
• currencies - показує в якій валюті можна відкрити компанію
• accounts - работа со счетами
• tags - работа с тегами
• projects - работа с проектами
• categories/income - работа с категориями дохода
• categories/expense - работа с категориями расходов
• customers - работа с клиентами
• investors - работа с инвесторами
• creditors - работа с кредиторами
• debitors - работа с заемщиками
• suppliers - работа с поставщиками
• employees - работа с сотрудниками
• owners - работа с владельцами
• operations/income - работа с операциями доходов
• operations/expense - работа с операциями расходов
• operations/transfer - работа с переводами

Для определенных блоков доступна возможность просмотра, редактирования, удаления, добавления. К таким блокам относятся:

• tags
• projects
• categories/income
• categories/expense
• customers
• investors
• creditors
• debitors
• suppliers
• employees
• owners

Через следующие блоки есть возможность только добавлять операции. К ним относятся:

• operations/income
• operations/expense
• operations/transfer

❌ Исключением является блок accounts, через этот блок можно только получать информацию о том, какие счета есть в сервисе.

Методы запросов 

• GET — используется для получения или чтения данных. Запросы с использованием этого метода могут только получать данные.
• PATCH — обычно используется для обновления ресурса, путем замены данных запроса.
• POST — обычно используется для создания нового ресурса причем, никто не увидит эту информацию после того, как вы ее отправили.
• DELETE — удаляет данные.

Лимиты запросов

На все методы API действуют общие лимиты на компанию:

• 10 запросов за 5 секунд
• 120 запросов в минуту
• 10 000 запросов в сутки

Раньше ограничение касалось только журнала операций — теперь лимиты единые для всех методов API.

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

• Remaining-Req-Count — сколько запросов ещё осталось в текущем окне;
• Next-Possibility-At — время, когда можно будет отправить следующий запрос, если лимит исчерпан.

Что сделать, чтобы не упираться в лимит:

• Вместо постоянного опроса API настройте вебхуки — Finmap сам сообщит об изменениях, и дополнительные запросы не понадобятся.
• Выгружайте данные пачками за период (например, все операции за день одним запросом), а не делайте отдельный запрос на каждую операцию.

Если ваша интеграция действительно требует большей пропускной способности, с 27.08.2026 доступен дополнительный пакет +100 запросов/мин: $10/мес, $60 за 6 месяцев или $120 в год.

Если остались вопросы

Если у вас возникнут вопрос о документации API или есть пример технического запроса, который вы хотите решить, пожалуйста, напишите нам на почту support-team@finmap.online.

В письме нужно описать следующее: "Запрос …, не работает (появляется такой ответ) когда вы отправляете параметры …". Наш технический специалист рассмотрит ваш запрос (обработка запросов происходит в пределах 24 часов) и предоставит квалифицированный ответ.