← На главную

Интеграции

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-телом на события:

{"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 и вебхуки; напишите нам, какой процесс нужен.