Skip to content

Tic-Tac-Toe Forfait ​

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

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.

Paramètres ​

ParamètreRequisDescription
gameOuiL'identifiant de la partie
usernameOuiLe nom d'utilisateur qui abandonne
sessionOuiL'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 ​

ChampTypeDescription
messagestringConfirmation du forfait
winnerstringNom d'utilisateur du gagnant (adversaire)
loserstringNom d'utilisateur du joueur qui abandonne

Exemples de code ​

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "game": "VWXYZ",
    "username": "alice",
    "session": "abc123"
  }' \
  "https://api.sylvain.sh/v6/tic-tac-toe/forfeit"

Essayer ​

Gestion des erreurs ​

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

Message d'erreurDescription
Session ID mismatchLa session ne correspond pas au joueur

Endpoints associés ​