API для разработчиков

Если ваша команда хочет интегрировать RentraAI со своими системами — у платформы есть REST API.

Где что находится

• Документация API — страница «API» в кабинете (/app/api): быстрый старт, аутентификация, справочник эндпоинтов, примеры для n8n, коды ошибок.
• Ключи API — Настройки → AI и администрирование → API Keys: создание ключа с правами (только чтение / чтение и запись / полный доступ) и сроком действия. Секрет ключа показывается один раз при создании — сохраните его сразу.

Как устроена аутентификация

1. Создайте API-ключ в настройках.
2. Обменяйте ключ на токен: POST /api-auth/token с телом {"api_key": "rta_..."}.
3. Используйте токен в заголовке Authorization: Bearer <token>. Токен живёт 1 час, затем запросите новый.

Что доступно через API

Категории эндпоинтов: организация, доступность и цены, инвентарь и синхронизация PMS, бронирования, контакты и лиды, сервисные задачи, услуги, база знаний, ответы AI.

Полные описания запросов и ответов — на странице «API» в кабинете.