Kalibro открыл публичное API

Сервис для управления выездными бригадами Kalibro открыл публичное API. Теперь компании могут подключать Kalibro к своим CRM, ERP и аналитическим системам через стандартные REST-запросы. Раньше для этого требовалась индивидуальная разработка под каждого клиента — теперь достаточно сгенерировать API-ключ в настройках компании (раздел «Интеграция»).

Почему это важно

Выездной сервис — это всегда две реальности. Диспетчер работает в Kalibro, менеджер — в CRM. Пока между ними нет моста, заявки дублируются вручную, статусы запаздывают, а адреса иногда уезжают не туда. По оценкам интеграторов, ручной перенос одной заявки занимает до 15 минут, а доля ошибок в адресах достигает 5%.

Публичное API закрывает этот разрыв. Теперь заявка создаётся в CRM — и автоматически появляется в Kalibro. Статус меняется в Kalibro — и мгновенно обновляется в CRM через вебхук.

Что умеет API

Заявки. Создание, чтение, обновление и мягкое удаление. Фильтрация по статусу, исполнителю, бланку и датам. Заявку можно назначить всем исполнителям, конкретному человеку или группе.

Вебхуки. Подписка на четыре события: order.created, order.state_changed, order.deleted, order.message.new. Kalibro сам отправляет POST-запрос на ваш сервер. Подпись HMAC-SHA256 в заголовке X-Webhook-Signature защищает от подделки. При ошибках доставки — до 5 повторов с возрастающим интервалом.

Справочники. Исполнители, заказчики, операторы, группы, бланки. Всё, что нужно для синхронизации данных между системами.

Аналитика. Горизонтальные отчёты по замерам, активность пользователей, сводная статистика, балансы и взаиморасчёты.

Цифры и лимиты

API работает по адресу /api/public. Лимит — 60 запросов в минуту на один ключ. При превышении возвращается 429 Too Many Requests. Для фоновой синхронизации этого достаточно с запасом. Пагинация — до 20 элементов на страницу, что позволяет выгружать до 1200 записей в минуту.

Что это значит для рынка

Публичное API — это сигнал, что Kalibro переходит из категории «инструмент для бригад» в категорию «платформа для интеграций». Компании, которые уже используют Kalibro, получают возможность встроить его в свой IT-ландшафт без боли. Те, кто только выбирает сервис, получают дополнительный аргумент: Kalibro не замыкает данные внутри себя.

Для интеграторов это тоже хорошая новость. Стандартный REST API с понятной документацией и OpenAPI-спецификацией означает, что типовой проект интеграции занимает дни, а не недели.

Полная документация доступна в спецификации OpenAPI. Для проверки соединения предусмотрен тестовый вебхук: POST /v1/webhooks/test.