#Développeurs

Construisez sur Disband : des bots, des intégrations et des outils qui communiquent avec vos espaces de l'extérieur. Tout ici est hébergé de manière autonome - Disband ne lance jamais votre code.

#Ce que vous pouvez construire

• Bots - comptes hébergés par eux-mêmes qui lisent et écrivent des messages, gèrent des chaînes, et réagir aux événements via un portail de sondage à long terme. Consultez l'Bots.
• Webhooks - notifications unidirectionnelles publiées via un URL secret, sans bot. Code ou jeton. Voir Webhooks.
• Cartes intégrées - notes de version structurées, alertes et mises à jour de statut. Voir Embeds.
• Clients personnalisés - parlez directement à HTTP API si vous avez besoin d'une langue. Les clients expédiés ne sont pas couverts. La référence Référence de l’API est Le contrat.
• Intégrations de statut - suivez les incidents Disband via RSS, ou lisez comment le État du système enregistre les vérifications et ouvre les incidents.

#Commencez ici

1. Premiers pas - créez un bot, obtenez son Token, invitez-le dans un espace. Environ deux minutes.
2. Héberger votre propre bot - où exécuter Le client et comment le maintenir en vie.
3. JavaScript ou Python.
4. Référence de l’API pour les points d'extrémité exacts.
5. Webhooks ou Embeds si vous n'avez besoin que de Notification unidirectionnelle.
6. État du système pour la page de statut publique et le flux RSS.

#Implémenter Disband dans un jeu ou une application.

Disband expose une API HTTP simple authentifié avec un jeton bot. Il n'y a pas de SDK natif ou de runtime RPC à lier - n'importe quelle pile qui peut effectuer des requêtes HTTPS fonctionne. Une intégration typique ressemble à ceci :

1. Créez un bot dans Paramètres → Bots et accordez-lui messages.write (et channels.manage si cela devrait créer des chaînes).

2. Invitez le bot dans l'espace dans lequel vous souhaitez poster.

3. Stocker le jeton dans le magasin secret de votre jeu ou de votre application - jamais sur le côté client. Code qui est envoyé aux joueurs.

4. À partir de votre backend, appelez les points d'extrémité scopés :

   curl -X POST https://www.disband.dev/api/v1/channels/CHANNEL_ID/messages \
     -H "Authorization: Bot $DISBAND_BOT_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content": "Server restarted — 12 players online."}'
   

5. Pour réagir au chat depuis l'intérieur de votre jeu, polluez le gateway en permanence et envoyez. Les événements messageCreate sont intégrés à la logique de votre jeu.

#Notes de sécurité

• Les jetons de bot sont hachés en repos et ne sont affichés qu'une seule fois. Annulez immédiatement s'il y en a un. Fuites.
• Gardez les jetons sur un serveur que vous contrôlez. L'expédition d'un jeton dans un client de jeu permet de Quelqu'un qui se fait passer pour votre bot.
• Limiter les rôles des bots à ceux dont ils ont le moins besoin. Un bot qui ne fait que publier n'a pas besoin de members.read ou channels.manage.

#Thèmes pour les développeurs

Si vous construisez un client ou une peau de marque, les variables CSS dans le Thèmes sont le style stabl'API.

#Questions

• Rapports de bugs : ouvrez un problème ou envoyez un e-mail à l'équipe.
• Pour les problèmes spécifiques au compte, utilisez le support intégré à l'application.