Développer

Commandes et interactions

Enregistrez des commandes et acquittez les interactions avec un message, une réponse différée, de l’autocomplétion ou un formulaire.

Enregistrer une commande

Les commandes globales sont rattachées à une application. Leur nom contient 1 à 32 caractères et est normalisé en minuscules. Les options utilisent des descripteurs typés ; dm_permission vaut true par défaut.

bash
curl -X POST https://beta.lyra.social/api/v1/applications/$APP_ID/commands \
  -H "Authorization: Bearer $LYRA_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "status",
    "description": "Show service status",
    "options": [],
    "dm_permission": false
  }'

Portée globale ou communautaire

MéthodeCheminFonction
GET/applications/:app_id/commandsLister les commandes globales
POST/applications/:app_id/commandsCréer une commande globale
PUT/applications/:app_id/commandsRemplacer toutes les commandes globales
DELETE/applications/:app_id/commands/:cmd_idSupprimer une commande globale
GET/guilds/:guild_id/commandsLister les commandes visibles dans une communauté
GET/guilds/:guild_id/commands/:app_idLister les commandes communautaires d’une application
PUT/guilds/:guild_id/commands/:app_idRemplacer les commandes propres à une communauté

Répondre à une interaction

INTERACTION_CREATE est transmis au bot via le Gateway. Le bot répond avec l’endpoint de callback. À l’exception de l’autocomplétion de type 8, une interaction ne peut être acquittée qu’une fois. Son jeton reste valide 15 minutes.

TypeSignification
1Pong
4Message avec source
5Message différé avec source
6Mise à jour différée du message
8Résultat d’autocomplétion
9Ouvrir un formulaire modal
bash
curl -X POST https://beta.lyra.social/api/v1/interactions/$INTERACTION_ID/callback \
  -H "Authorization: Bot $LYRA_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"interaction_type":4,"data":{"content":"All systems operational."}}'