Aller au contenu
Accueil moxon

Récupération du morpion

L'endpoint /tic-tac-toe/fetch permet de récupérer les informations d'une partie de morpion en cours. Vous pouvez utiliser l'identifiant de la partie en cours pour l'afficher ou créer une nouvelle partie si aucun ID n'est fourni.

posthttps://api.moxon.dev/v6/tic-tac-toe/fetch
Essayerpost/v6/tic-tac-toe/fetch

Paramètres

  • usernamestringrequis

    Le nom d'utilisateur effectuant la requête

  • gamestringoptionnel

    L'identifiant de la partie à afficher. S'il n'est pas fourni, un nouvel identifiant de partie sera généré

  • privatebooleanoptionnel

    Booléen JSON : true pour créer une partie privée (défaut : false). Pris en compte uniquement à la création de la partie

Exemples de code

Champs de réponse

  • idstring

    Identifiant de la partie

  • movesobject[]

    Tableau des coups joués

  • playersstring[]

    Tableau des noms d'utilisateur des joueurs

  • turnstring|null

    Nom d'utilisateur du joueur dont c'est le tour

  • statusstring

    Statut de la partie (waiting, ready)

  • privateboolean

    Si la partie est privée

  • winnerstring|null

    Nom d'utilisateur du gagnant (partie terminée)

  • loserstring|null

    Nom d'utilisateur du perdant (partie terminée)

  • tieboolean

    Si la partie s'est terminée par une égalité

Valeurs de statut de partie

StatutDescription
waitingLa partie a moins de 2 joueurs
readyLa partie a 2 joueurs et est prête à être jouée

Gestion des erreurs

Si les paramètres sont manquants ou invalides, l'API retournera une erreur :

  • 400Please provide a username (?username={username})Le paramètre username est manquant

Lorsqu'une nouvelle partie est créée, l'utilisateur est automatiquement ajouté à la liste des joueurs. Les parties privées ne sont pas visibles dans la liste publique des parties mais peuvent toujours être rejointes si vous connaissez l'ID de la partie.