AlfyChat
Langage :

Scopes

OAuth2

Les scopes définissent les accès que votre application demande à l'utilisateur.

Référence des scopes

botAjouter le bot à un serveur

Permet à votre bot d'être ajouté à un serveur AlfyChat. L'utilisateur doit être propriétaire ou administrateur du serveur cible. Le bot sera ajouté avec les permissions spécifiées dans le paramètre permissions (bitmask).

Exemple
scope=scope=bot&permissions=3
identifyLire le profil de l'utilisateur

Permet de récupérer l'identifiant, le nom d'utilisateur, le displayName et l'avatar de l'utilisateur connecté. Aucune donnée sensible (email, téléphone) n'est exposée.

Exemple
scope=scope=identify
Endpoints débloqués
GET /api/users/me
guildsLister les serveurs de l'utilisateur

Permet de récupérer la liste des serveurs AlfyChat dont l'utilisateur est membre. Inclut : id, name, icon, memberCount, et le rôle de l'utilisateur dans chaque serveur.

Exemple
scope=scope=guilds
Endpoints débloqués
GET /api/servers/me

Combiner les scopes

Séparez les scopes par des espaces dans l'URL (encodés en + ou %20) :

// Ajouter le bot + lire le profil + lister les serveurs
const scope = ['bot', 'identify', 'guilds'].join(' ');
const params = new URLSearchParams({ client_id, redirect_uri, scope });

Permissions bitmask (scope bot)

Quand le scope bot est demandé, le paramètrepermissions précise les droits accordés au bot sur le serveur.

PermissionValeurDescription
READ_MESSAGES0x1Lire le contenu des salons
SEND_MESSAGES0x2Poster dans les salons textuels
ADD_REACTIONS0x4Ajouter des réactions
MANAGE_MESSAGES0x8Supprimer et épingler des messages
KICK_MEMBERS0x10Exclure des membres
BAN_MEMBERS0x20Bannir des membres
ADMINISTRATOR0x40Accès complet (inclut toutes les permissions)
MANAGE_CHANNELS0x80Créer, modifier et supprimer des salons
MANAGE_ROLES0x100Créer, modifier et supprimer des rôles
// READ_MESSAGES | SEND_MESSAGES | ADD_REACTIONS = 0x7
const permissions = 0x1 | 0x2 | 0x4; // → 7