API для разработчиков
Внешние системы могут работать с Paloma365 через API: получать справочники и продажи, создавать документы, подключать доставку и маркетплейсы. Эта статья — о том, где документация, как получить доступ и что означает ошибка «нет разрешения на этот API».
Условия
При использовании API в коммерческих целях с компанией заключается индивидуальный договор или согласуются отдельные условия. Если вы планируете интеграцию, напишите в этот чат — специалист расскажет условия и подключит нужные разрешения.
Документация
Интерактивная документация (Swagger UI), где каждый метод можно вызвать прямо со страницы:
- Paloma365 — https://alfaposapi.paloma365.com/api/v2/docs
- PalomaPOS — https://alfaposapi.palomapos.com/api/v2/docs
Все методы требуют заголовок Authorization: Bearer <ключ>. Страница документации — единственный адрес, который открывается без ключа.
Ключи доступа
Ключи создаются и отзываются в личном кабинете, раздел «Приложения». Ключ выдаётся на аккаунт: он определяет, к каким данным есть доступ, поэтому его нельзя передавать посторонним. Скомпрометированный ключ отзывается там же, и вместо него выпускается новый.
Ошибка «нет доступа» или «API не разрешён»
Это не сбой интеграции и не поломка на нашей стороне: у аккаунта просто не включено разрешение на конкретный API. Что делать:
- Откройте раздел «Приложения» в личном кабинете и проверьте, включена ли нужная интеграция и выпущен ли ключ.
- Убедитесь, что запрос уходит с заголовком
Authorization: Bearer <ключ>и что ключ не отозван. - Если разрешение включить не удаётся — напишите здесь же: часть API открывается только после согласования условий, и это делает специалист.
Отдельно: ключ, выпущенный на одном аккаунте, не работает с данными другого. Если интеграция настроена на нескольких заведениях, ключ нужен для каждого аккаунта.
Что смотреть по темам
- Журнал обращений к API — какие запросы приходили и с каким результатом: «Лог запросов API».
- Готовые интеграции (доставка, маркетплейсы, Telegram, Bitrix24) — их подключают переключателем, без программирования: «Интеграции».
- MCP-коннектор — отдельный способ подключить AI-помощника к данным аккаунта: «MCP-коннектор».