AlfyChat Developer Hub

Architecture d'un bot AlfyChat, cycle de vie, flux de démarrage, connexion Socket.IO et exemple de bot minimal en 4 langages.

Enregistrement via POST /api/bots, récupération du token (affiché une seule fois), modification des métadonnées et suppression.

Header Authorization: Bot <token>, validation du token côté bot, gestion des 401/403 et bonnes pratiques de stockage sécurisé.

Envoi de messages en DM, dans un salon de serveur ou en réponse — REST et WebSocket, mentions et pièces jointes.

Déclaration de commandes par prefix, cooldown par utilisateur/serveur, parsing des arguments et aide automatique.

Système de permissions en bitmask — SEND_MESSAGES, MANAGE_MEMBERS, BAN_MEMBERS, ADMINISTRATOR — vérification runtime.

Obtenir le badge officiel ✅ : prérequis (100+ serveurs, conformité RGPD), processus de review et avantages techniques.

Vue d'ensemble du système OAuth2 AlfyChat — authorization code flow, client_id/client_secret, scopes et redirect URIs.

Authorization code flow pas-à-pas — redirect vers /oauth2/authorize, échange de code contre access_token et appels authentifiés.

Référence complète des scopes OAuth2 : bot (ajouter à un serveur), identify (profil utilisateur), guilds (liste des serveurs).

URL de base (https://gateway.alfychat.app), architecture 8 microservices, en-têtes communs, CORS et format des réponses JSON.

JWT Bearer (15 min) + refresh token (1 an), sessions WebSocket, révocation de session et bonnes pratiques de sécurité.

Vue d'ensemble des 50+ endpoints REST — routes, auth requise, pagination par curseur et format général des erreurs.

Connexion Socket.IO v4, rooms auto-jointes, heartbeat 30s, event READY, gestion des déconnexions et CALL_REJOIN.

Référence des 80+ events Socket.IO — appels WebRTC, messages DM/serveur, présence, archive P2P et groupes.

Rate limiting (100 req/min global, 5 msg/5s WebSocket), codes HTTP, format d'erreur JSON et wrapper de retry avec backoff.

Inscription, connexion, refresh, révocation de session. Droits RGPD : export ZIP de données et suppression irréversible de compte.

Profil complet, modification du displayName/bio/avatar, préférences (thème, langue, notifications), statut de présence et lastSeen.

CRUD messages DM/groupe, réactions, pagination par curseur UUID, notifications et système d'archive P2P hybride client/serveur.

Demandes d'ami, acceptation/refus, blocage/déblocage, side-effects WebSocket temps réel et historique des appels audio/vidéo.

CRUD serveurs, channels (text/voice/announcement), membres, rôles, invitations, upload de fichiers et routing vers server-nodes.

Création, authentification, gestion des commandes, ajout dans les serveurs, annuaire public et soumission à la certification.

Upload multipart/form-data par type (avatars, banners, icons, attachments), CDN géo-distribué EU/US et conversion auto WebP.

Stats rate-limiting, ban/déban d'IP, monitoring des microservices, gestion des incidents, status public et endpoints internes.