Платформа разработчика Chattr
В Chattr есть три вида приложений:
- Вебхуки: отправляют сообщения в один текстовый канал по URL.
- Интеграции: используют Bearer-токены для управления участниками сервера.
- OAuth-приложения: позволяют внешнему сайту определить пользователя Chattr.
Быстрая карта
- Начните с вебхуков, если вам нужна только отправка сообщений.
- Выберите интеграции, если требуется синхронизация ролей, никнеймов или модерационного статуса.
- Добавьте OAuth, если ваш сайт должен понимать, какой аккаунт Chattr подключён.
Кто может создавать и управлять приложениями
| Тип приложения | Кто может создать | Кто может управлять |
|---|---|---|
| Вебхук | Любой участник с правом manage_server |
То же — manage_server на этом сервере |
| Интеграция | Любой участник с правом manage_server |
То же — manage_server на этом сервере |
| OAuth | Любой пользователь с подтверждённым телефоном | Только владелец приложения |
Право manage_server автоматически выдаётся владельцу сервера и администраторам. Его также можно назначить любой пользовательской роли.
Модель безопасности
- Доступ к действиям в рамках сервера выдаётся явно менеджерами сервера.
- Сторонний OAuth остаётся только идентификационным.
- Только first-party портал разработчика Chattr получает пользовательские access tokens.
URL
- Публичная OAuth-авторизация:
/oauth/authorize - Обмен OAuth-кода на токен:
/oauth/token - Runtime URL для вебхуков:
/webhooks/:appId/:token - Management API:
/api/apps/*