Платформа разработчика

Подключайте сервисы к Chattr.

Четыре типа приложений: вебхуки, интеграции, виджеты и OAuth.

ВебхукиИнтеграцииВиджетыOAuth
Вебхук

POST JSON на подписанный URL — сообщение появится в нужном канале.

POST /webhooks/:appId/:token
Интеграция

Управляет ролями и участниками сервера по выданному токену.

Authorization: Bearer <token>
Виджет

Предопределённые строки (счётчик, статус, прогресс), одна плитка закрепляется в боковой панели.

POST /widgets/:appId/:token
OAuth

Только идентификация — user ID, никнейм, имя и URL аватара.

GET /oauth/authorize
POST /oauth/token
Вебхуки

Отправляйте сообщения в канал

Создайте вебхук, выберите канал и получите URL. Отправьте на него POST-запрос с текстом — сообщение появится в канале. Один URL привязан к одному каналу.

  • Привязан к серверу и каналу при создании
  • URL можно обновить в любой момент
  • Не требует заголовков авторизации — токен встроен в URL
POST /webhooks/:appId/:token
{"content":"Hello!"}
Документация по вебхукам →
Интеграции

Управляйте участниками сервера

Подключите внешнюю систему — она сможет управлять ролями, никнеймами и статусом участников на вашем сервере. Токены привязаны к серверу и показываются один раз при создании.

  • Управление ролями, никнеймами и модерацией
  • Несколько токенов на приложение с отдельными названиями
  • Каждый токен можно отозвать в любой момент
Виджеты

Метрики в боковой панели

Присылайте предопределённые строки — счётчики, статусы, прогресс — и закрепляйте одну плитку под шапкой сервера. Каждый POST полностью заменяет предыдущий снапшот.

  • Четыре типа строк: counter, status, text, progress
  • Один закреплённый виджет на сервер, остальные — в модалке
  • Видимость переключается отдельно — скрытый виджет не принимает данные
POST /widgets/:appId/:token
{"rows":[{"kind":"counter","label":"Online","value":42}]}
Документация по виджетам →
OAuth

Идентифицируйте аккаунты

Перенаправьте пользователей на страницу входа в Chattr и получите их данные: ID, имя и аватар. OAuth-приложения получают только идентификацию — без доступа к управлению.

  • Стандартный authorization code flow
  • Redirect URI настраивается на уровне приложения
  • Портал разработчика Chattr получает расширенный доступ
GET /oauth/authorize
POST /oauth/token
Документация по OAuth →