API для проката: как подключить 1С, сайт или бота к AllRent-CRM (инструкция и примеры)

Если у вас есть сайт, 1С, Telegram-бот или таблица, в которую вы вручную переносите аренды, всё это можно связать с AllRent-CRM через открытое API. Оно доступно всем организациям бесплатно, пока оплачен тариф. Ниже — как подключиться за пять минут и какие задачи прокатчики решают с его помощью.

🔑 Шаг 1. Выпустите токен

Откройте меню пользователя (внизу слева) и выберите пункт «Доступ по API». Он доступен владельцу и сотрудникам с правом на раздел «Настройки интеграций».

Введите название — для кого токен, например «1С» или «Сайт» — и нажмите «Выпустить». Токен показывается один раз: скопируйте его сразу. В системе хранится только хеш, поэтому потерянный токен не восстановить — отзовите его и выпустите новый.

• Токен привязан к вашей организации и видит только её данные.
• Права токена равны правам пользователя, который его выпустил. Для интеграции удобно завести отдельного сотрудника с нужными разделами и выпустить токен под ним.
• Токен работает, пока оплачена подписка. Если срок истёк, API отвечает 401 TOKEN_EXPIRED, после продления тот же токен снова принимается.
• Токенов можно держать до 10 одновременно — отдельный на каждую интеграцию, чтобы отзывать их по одному.

🚀 Шаг 2. Первый запрос

Токен передаётся в заголовке Authorization: Bearer ТОКЕН. Проверьте доступ запросом GET /ping — он вернёт организацию и пользователя, от имени которых работает токен:

curl -H "Authorization: Bearer ВАШ_ТОКЕН" https://allrent-crm.ru/api/v1/ping

Ответ 200 означает, что всё настроено верно. Все ответы приходят в JSON, списки разбиты на страницы, ошибки имеют понятный код (VALIDATION_FAILED, INVENTORY_BUSY, ACCESS_DENIED и другие).

🧪 Шаг 3. Попробуйте в документации

У API есть своя страница документации: allrent-crm.ru/api/docs/. Вставьте токен в поле вверху, откройте любой метод и нажмите «Выполнить запрос» — страница отправит настоящий запрос и покажет ответ. Рядом готовый пример curl и описание всех полей.

📚 Что умеет API

• Аренды: создание, изменение, оплата и залог, завершение, отмена, комментарии, печатная форма договора (HTML, PDF, DOCX).
• Клиенты и источники — поиск по телефону и e-mail, создание и правка.
• Инвентарь, комплекты, категории, тарифы, точки проката и проверка свободного остатка на период.
• Деньги: расходы, кассы, операции по кассам, способы оплаты.
• Магазин и сервис: товары, продажи, ремонты и услуги.
• Сотрудники, лояльность, сводка за период.
• Вебхуки — система сама сообщает о новых арендах, оплатах и изменениях клиентов.

Цену и залог при создании аренды API считает сам — по тем же правилам, что и сайт: тарифы, скидка клиента, свободные остатки. Вам не нужно повторять эту логику у себя.

🧩 Кейсы: что делают с API прокатные организации

1. Онлайн-бронирование на своём сайте

Задача. На сайте проката клиент выбирает даты и снаряжение и сразу видит, что свободно, а заявка превращается в аренду в CRM без звонка менеджеру.

Как. Метод GET /availability отдаёт по каждой позиции общий остаток, сколько занято открытыми арендами и сколько свободно на период:

curl -H "Authorization: Bearer ТОКЕН" \
  "https://allrent-crm.ru/api/v1/availability?start=2026-11-01T10:00:00%2B05:00&end=2026-11-02T10:00:00%2B05:00"

Когда клиент оформляет заказ, сайт находит или создаёт клиента (GET /customers?phone=…, POST /customers) и создаёт аренду:

curl -X POST -H "Authorization: Bearer ТОКЕН" -H "Content-Type: application/json" \
  https://allrent-crm.ru/api/v1/rents -d '{
    "customer_id": 1,
    "start": "2026-11-01T10:00:00+05:00",
    "end": "2026-11-02T10:00:00+05:00",
    "items": [{"item_id": 5, "quantity": 1}]
  }'

Если позицию в этот момент успели занять, API вернёт 409 INVENTORY_BUSY — покажите клиенту другое время или другую позицию.

2. Бот в Telegram или мессенджере

Задача. Бот отвечает «есть ли свободные сапы на субботу» и принимает бронь.

Как. Та же пара методов: /availability для проверки наличия и POST /rents для брони. Отдельного бота делать не обязательно: подойдёт любой конструктор или скрипт, умеющий отправлять HTTP-запросы.

3. Обмен с 1С и бухгалтерией

Задача. Аренды, оплаты и расходы попадают в 1С без ручного ввода.

Как. Раз в несколько минут опрашивайте списки с параметром updated_since — вы получите только то, что изменилось после последнего обмена: /rents, /expenses, /cash-transactions. Чтобы не опрашивать вовсе, подпишитесь на вебхуки (кейс 5).

4. Отчёты в Google Таблицах и BI

Задача. Руководитель хочет видеть выручку, расходы и прибыль в своей таблице или на дашборде.

Как. Метод GET /reports/summary?period_from=2026-10-01&period_to=2026-10-31 возвращает сводку по арендам, продажам, ремонтам и расходам за период. Для детального отчёта берите списки с фильтрами по периоду.

5. Мгновенные уведомления и вебхуки

Задача. Менеджеру в Telegram приходит сообщение о каждой новой аренде, а система учёта обновляется сама.

Как. Создайте вебхук — адрес вашего сервера и список событий:

curl -X POST -H "Authorization: Bearer ТОКЕН" -H "Content-Type: application/json" \
  https://allrent-crm.ru/api/v1/webhooks -d '{
    "url": "https://example.com/hooks/allrent",
    "events": ["rent.created", "payment.created"],
    "description": "Уведомления менеджеру"
  }'

События срабатывают на любые изменения — сделанные на сайте, в приложении или через API: rent.created, rent.closed, rent.cancelled, payment.created, customer.created и другие. Каждый запрос подписан секретом вебхука (заголовок X-AllRent-Signature), поэтому вы можете убедиться, что он пришёл от AllRent-CRM. Если ваш сервер недоступен, доставка повторяется несколько раз с нарастающими паузами.

6. Массовая загрузка и обновление каталога

Задача. Прайс или список инвентаря живёт в таблице — нужно загрузить его в CRM или регулярно обновлять цены.

Как. Скрипт читает таблицу и вызывает POST /inventory для новых позиций и PATCH /inventory/{id} для изменений. Категории, тарифы и комплекты настраиваются теми же способами.

🛠 Порядок создания аренды через API

Типовой сценарий занимает шесть запросов:

✅ Что важно знать

• Уведомления клиентам. По умолчанию API не отправляет SMS и сообщения клиентам при создании и завершении аренды. Чтобы отправить их, как с сайта, передайте "notify": true.
• Время. Даты передаются в формате ISO 8601 со смещением часового пояса, например 2026-11-01T10:00:00+05:00.
• Лимиты. 120 запросов в минуту на токен; при превышении приходит 429 и заголовок Retry-After.
• Совместимость. Формат ответов зафиксирован и покрыт тестами: доработки сайта не ломают интеграции.
• Безопасность. Не храните токен в публичном коде и браузере посетителей: запросы к API делает ваш сервер. Подозреваете утечку — отзовите токен на странице «Доступ по API».