# MeridianHub App Store — developer docs index

MeridianHub — корпоративный чат. Магазин приложений: разработчик регистрирует
«корень» приложения, клиенты подключают его к своим эккаунтам («установки»).
API base: https://chat-api.meridianhub.ru

## Docs

- [guide.md](guide.md): полный гайд по-русски — быстрый старт, установка,
  разбор событий и проверка подписи, эндпоинты /v1/bot/* (сообщения с
  кнопками/entities/reply_to/идемпотентностью, правка и удаление, беседы,
  вложения), каналы по ключу, мини-приложение, автостарт, метки и
  платформенный выпуск ссылок, таблица перевода со старых путей,
  миграция со старых бот-токенов, режим Slack: домены ссылок
  (unfurl_domains, meridian.domains.add).
- [events.md](events.md): образцы и JSON-схемы событий вебхука
  (bot.connected, bot.disconnected, message, callback_query).
- [openapi.json](openapi.json): OpenAPI 3.1 — /v1/bot/* (auth: Bearer
  mh_app_-ключ установки), /v1/dev/* (консоль разработчика, auth:
  юзер-сессия), /v1/chat/apps/* (подключение клиентом).
- [llms-full.txt](llms-full.txt): guide.md + events.md одним файлом.
- [skill.md](skill.md): скилл-справочник для LLM-агента: три контекста
  работы (платформа mh_pl_, токен эккаунта, установка бота mh_app_),
  границы и лимиты каждого токена, легаси-контур.

## Key facts

- Секрет бота (webhook_secret) подписывает входящие события и initData
  мини-приложения: HMAC-SHA256("{timestamp}.{raw_body}"), заголовки
  X-Meridian-Timestamp / X-Meridian-Signature ("sha256=<hex>") /
  X-Meridian-Signature-Previous (час после плановой ротации).
- Основной ключ — ключ бота mh_bot_…: один на приложение, выдаётся при
  создании в консоли (показывается один раз, ротация там же). Все вызовы
  /v1/bot/* — Authorization: Bearer <ключ>. Установка определяется
  адресом (conversation_id/message_id) или селектором
  account_id|external_tenant_ref.
- GET /v1/bot/connections — все подключения бота (сверка вместо ловли
  каждого bot.connected).
- Ключ установки mh_app_… (продвинутый режим) приходит один раз в
  событии bot.connected; сохранять его не обязательно.
- Пределы: 120 вызовов/мин на установку (429 + Retry-After), создание
  бесед 30/час, доставка — 5/с на адрес, ретраи 5с→300с до 72 часов.
- Бот пишет только в беседы, где состоит участником; гостевые ссылки —
  в любой чат места. bot.connected несёт connect_link{token,
  external_ref} и bot{user_id, username, display_name}.