Aller au contenu
Accueil moxon

Tic-Tac-Toe Forfait

L'endpoint /tic-tac-toe/forfeit permet d'abandonner une partie (forfait).

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

Changement en 6.0.0

Cet endpoint passe de DELETE à POST, et son identifiant sort de l'URL : game est désormais envoyé dans le corps JSON. Les méthodes PATCH et DELETE n'existent plus nulle part dans l'API.

Essayerpost/v6/tic-tac-toe/forfeit

Paramètres

  • gamestringrequis

    L'identifiant de la partie

  • usernamestringrequis

    Le nom d'utilisateur qui abandonne

  • sessionstringrequis

    L'identifiant de session de l'utilisateur

À savoir

Tous les paramètres sont envoyés dans un body JSON avec Content-Type: application/json.

Champs de réponse

  • messagestring

    Confirmation du forfait

  • winnerstring|null

    Nom d'utilisateur du gagnant (adversaire), null si le joueur était seul dans la partie

  • loserstring

    Nom d'utilisateur du joueur qui abandonne

La partie est supprimée après un forfait.

Exemples de code

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
  • 400Please provide a valid session ID (&session={ID})Le paramètre session est manquant
  • 400Please provide a game ID (&game={ID})Le paramètre game est manquant
  • 400Game not foundLa partie n'existe pas
  • 400Session ID mismatchLa session ne correspond pas au joueur
  • 400You are not a player in this gameLe joueur ne participe pas à cette partie