Référence APIDiscord users

Discord users

Liaison entre le login 01 Edu d’un apprenant et son discord_id. Permet au bot Discord de cibler un message individuel (DM, mention, ping ciblé).

Source : src/api/v1/discord_users.ts, src/db/schema/discord_users.schema.ts, src/services/dto/discord_users.dto.ts.

Voir aussi le schéma DiscordUser.


Lister tous les liens

GET/api/v1/discord-userssource ↗

Réponse 200

[
  {
    "id": 1,
    "login": "alice",
    "discord_id": "1234567890",
    "created_at": "2024-09-12T10:00:00.000Z",
    "updated_at": "2024-09-12T10:00:00.000Z"
  }
]

Récupérer le lien d’un apprenant

GET/api/v1/discord-users/:loginsource ↗
NomTypeLocalisationDescription
loginstringpathLogin 01 Edu

Erreurs

CodeCause
404Aucun lien pour ce login

Créer / mettre à jour un lien (upsert)

PUT/api/v1/discord-userssource ↗

Insère le lien s’il n’existe pas, le met à jour sinon. La clé d’unicité est le login.

Body (JSON)

{
  "login": "alice",
  "discord_id": "1234567890"
}
ChampTypeRequisDescription
loginstringLogin 01 Edu
discord_idstringID Discord (snowflake)

Réponse 200

L’objet créé ou mis à jour.


Supprimer un lien

DELETE/api/v1/discord-users/:loginsource ↗

Réponse

204 No Content.

Erreurs

CodeCause
404Aucun lien pour ce login