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

Открытый API электронных журналов ХАССП: MCP для ChatGPT и Claude, REST API v1 с описанием OpenAPI, записи в журналы, показания датчиков, сводка за день, вебхуки.

ИИ-ассистенты (MCP)

WeSetup — MCP-сервер: ChatGPT, Claude, Cursor и другие ассистенты сами узнают статус журналов, отмечают ячейки и добавляют сотрудников по просьбе пользователя. Ключ действует с правами его владельца и только в его организации; каждая запись видна в журнале действий. Поддерживаются спецификации MCP 2026-07-28 и 2025-03-26…2025-11-25 (Streamable HTTP).

# ключ в заголовке — Claude Code, Cursor, свой клиент
POST https://wesetup.ru/api/mcp
Authorization: Bearer wsk_…

# ключ в ссылке — коннекторы claude.ai и ChatGPT
POST https://wesetup.ru/api/mcp/wsk_…
  • get_context — Организация, сегодняшняя дата в её часовом поясе, права ключа.
  • list_journals — Журналы на дату: что заполнено, что нет, активные документы со ссылками.
  • get_journal_document — Записи документа за период до 31 дня.
  • fill_journal_cells — Заполнить ячейки журнала-сетки (сотрудники × даты) по правилам интерфейса.
  • list_employees — Сотрудники с должностями и телефонами, список должностей.
  • add_employee — Добавить сотрудника с учётом тарифа.
Получить ключ
REST API v1

Те же операции обычными HTTP-запросами с персональным ключом. Ответ — { ok, data } или { ok: false, error }; повтор POST с тем же Idempotency-Key возвращает прежний ответ. Полное описание — openapi.json.

GET/api/v1/meОрганизация, сегодняшняя дата в её часовом поясе, права ключа.
GET/api/v1/journals?date=Журналы на дату: что заполнено, что нет, активные документы со ссылками.
GET/api/v1/documents/{id}?from=&to=Записи документа за период до 31 дня.
POST/api/v1/documents/{id}/cellsЗаполнить ячейки журнала-сетки (сотрудники × даты) по правилам интерфейса.
GET/api/v1/employees?query=Сотрудники с должностями и телефонами, список должностей.
POST/api/v1/employeesДобавить сотрудника с учётом тарифа.
curl https://wesetup.ru/api/v1/journals \
  -H "Authorization: Bearer wsk_…"
Авторизация

Персональный ключ для MCP и REST API v1 выпускает руководитель в кабинете: «Остальное → ИИ-ассистенты и API». Общий ключ организации для методов /api/external/* ниже — там же, в блоке «Ключ для датчиков и старых интеграций». Передавайте ключ в заголовке Authorization: Bearer <ключ>. Все запросы с ключом пишутся в организацию ключа — organizationId указывать не нужно. Утёк — отзовите ключ, он перестанет работать сразу.

Интеграции и датчики

POST/api/external/entries
Запись в журнал

Создаёт запись в полевом журнале организации. Повтор с тем же Idempotency-Key возвращает прежний ответ без дубля.

curl -X POST https://wesetup.ru/api/external/entries \
  -H "Authorization: Bearer <ключ организации>" \
  -H "Idempotency-Key: 6f1c…" \
  -H "Content-Type: application/json" \
  -d '{
    "journalCode": "hygiene",
    "date": "2026-09-10",
    "data": { "status": "healthy", "temperatureAbove37": false }
  }'
POST/api/external/sensors
Показание датчика

Один вызов — один замер температуры или влажности по оборудованию; отклонения от нормы сразу уходят в уведомления.

curl -X POST https://wesetup.ru/api/external/sensors \
  -H "Authorization: Bearer <ключ организации>" \
  -H "Content-Type: application/json" \
  -d '{ "equipmentId": "clx…", "type": "temperature", "value": 3.8, "timestamp": "2026-09-10T08:00:00+03:00" }'
GET/api/external/summary?date=2026-09-10
Сводка за день

Какие журналы заполнены, какие нет, отклонения и задачи — для панелей и интеграций с учётом.

curl https://wesetup.ru/api/external/summary?date=2026-09-10 \
  -H "Authorization: Bearer <ключ организации>"
GET/api/external/healthz
Проверка доступности

Без ключа. Отвечает 200, если API живо; для мониторинга интеграции.

curl https://wesetup.ru/api/external/healthz
Идемпотентность и ошибки
  • • Idempotency-Key — любой уникальный ключ до 128 символов; повтор в течение 48 часов возвращает тот же ответ.
  • • 401 — нет или неверный ключ; 400 — тело не прошло проверку, в ответе поле error; 429 — превышен лимит, подождите минуту.
  • • Даты — ISO 8601, время организации задаётся её часовым поясом.
Вебхуки

WeSetup может сам присылать события на ваш адрес: запись в журнале, отклонение, задача CAPA, оплата, статус идеи. Подписки настраиваются в «Настройки → Вебхуки»; каждый вызов подписан X-WeSetup-Signature (HMAC-SHA256 тела вашим секретом), неудачные доставки повторяются.

Статус и изменения API

Работает ли сервис — на странице статуса. Изменения API попадают в «Что нового» и RSS. Вопросы — support@wesetup.ru.

Получить ключ