API и вебхуки: подключите MEXUM к системам вашей компании
1. Создайте API-ключ
В кабинете откройте Аккаунт → API-ключи и создайте ключ. Он показывается один раз: храните его как пароль. Передавайте в заголовке:
Authorization: Bearer mxm_live_xxxxxxxxxxxxxxxx
2. Отправьте документ и следите за проверкой
curl -X POST https://app.mexum.online/documents/upload \
-H "Authorization: Bearer $MEXUM_KEY" \
-F "file=@dogovor.pdf" \
-F "client_task=Проверить удержание и сроки оплаты"
# в ответе придёт "task_id"
curl https://app.mexum.online/documents/{task_id}/status \
-H "Authorization: Bearer $MEXUM_KEY"
Выданное заключение в PDF доступно по адресу GET /documents/{task_id}/report после выдачи.
3. Получайте вебхуки
В Аккаунт → Вебхук укажите HTTPS-адрес. MEXUM отправит POST с JSON-телом на события:
check.completed: автоматизированная проверка завершена;check.failed: проверку не удалось завершить;report.issued: выдано итоговое заключение;ping: кнопка «Отправить тест».
{"event":"check.completed","created_at":"2026-11-20T10:15:00+00:00",
"data":{"task_id":123,"code":"AB123","status":"done","report_ready":false,
"url":"https://app.mexum.online/cabinet/task/123"}}
В событии только номер проверки, статус и ссылка. Текста документов, цитат и персональных данных там нет. Адреса во внутренних сетях отклоняются, перенаправления не выполняются, неудачная отправка повторяется один раз.
4. Проверьте подпись
В каждом запросе есть заголовки X-Mexum-Timestamp и X-Mexum-Signature. Подпись: sha256= и HMAC-SHA256 строки время + "." + тело с вашим секретом (он показывается один раз при сохранении вебхука).
import hmac, hashlib
def valid(secret, timestamp, body, header):
mac = hmac.new(secret.encode(), timestamp.encode() + b"." + body, hashlib.sha256).hexdigest()
return hmac.compare_digest("sha256=" + mac, header)
Отклоняйте запросы со временем старше нескольких минут.
1С, Битрикс24, n8n и Make
Укажите адрес приёма вебхука из вашей системы (например, «Входящий вебхук» Битрикс24 или узел Webhook в n8n и Make) и направляйте событие куда нужно: сообщение в рабочий чат, строка в таблице, задача в CRM. Для 1С используйте HTTP-сервис, принимающий такие запросы. Если вам нужен готовый коннектор, напишите нам, какой именно процесс нужен.
Частые вопросы
Есть ли публичный API?
Да. Любой аккаунт может создать API-ключ и пользоваться теми же методами, что и кабинет: загрузка, статус, скачивание заключения.
Попадают ли документы в вебхук?
Нет. В событии только номер, статус и ссылка на проверку в кабинете.
Есть ли готовые коннекторы для 1С и Битрикс24?
Пока нет. Подключение делается через API и вебхуки; напишите нам, какой процесс нужен.
