Alchem
Партнёрам

Подключите свой сервис к салонам на Alchem

Для разработчиков приложений и интеграторов: салон выдаёт вашему приложению доступ одним нажатием, вы получаете ключ с нужными правами и события установки.

Документация API
Событие установки
install · uninstall · freeze · unfreeze
HTTP
POST <webhook_url>
X-Alchem-Event: install
X-Alchem-Signature: sha256=<hex>

{
  "event": "install",
  "application": "<app_code>",
  "business_id": "<business_id>",
  "installation_id": "<installation_id>",
  "status": "pending",
  "scopes": ["appointments:read", "availability:read"],
  "occurred_at": "2026-10-01T05:00:00Z"
}

Как подключить приложение

  1. Шаг 1

    Напишите нам

    Расскажите о приложении. Мы заводим его в каталоге Alchem: права, адрес установки, адрес для событий и ключ разработчика.

  2. Шаг 2

    Салон выдаёт доступ

    В «Настройки → Интеграции → Приложения» салон видит, какие права просит приложение, и выбирает филиалы. Установка ждёт вашего подтверждения.

  3. Шаг 3

    Вы подтверждаете установку

    Ключом разработчика выпустите ключ установки и вызовите /app/callback — приложение становится подключённым.

  4. Шаг 4

    Работаете через API

    Ключ установки действует в пределах выданных прав и прав сотрудника, который выдал доступ. Отключить приложение может и салон, и вы.

Что получает партнёр

API партнёра

Список установок, одна установка, отключение и выпуск ключа — по ключу разработчика, до 600 запросов в минуту.

События установки

install, uninstall, freeze и unfreeze — POST на ваш адрес с подписью X-Alchem-Signature (HMAC-SHA256 секретом приложения).

Доставка с повторами

Не ответили 2xx — повторим через 1 и 5 минут, 30 минут, 2 и 6 часов.

Те же права, что у ключей

Записи, клиенты, контакты, услуги, мастера, свободное время и звонки — салон видит, что выдаёт.

  • GET/apps/installationsУстановки приложения у салонов
  • GET/apps/installations/{business_id}Одна установка
  • POST/apps/installations/{business_id}/uninstallОтключить приложение у салона
  • POST/apps/installations/{business_id}/keyВыпустить ключ установки

Частые вопросы

Коротко о том, как устроен Alchem и с чего начать.

Обсудим подключение

Начните с документации API — контакт для партнёров скоро появится на этой странице.

Документация APIИнтеграции