Vérification de captcha

L'endpoint /captcha vérifie une réponse soumise pour un captcha en mode challenge : renvoyez le jeton issu de l'en-tête X-Captcha-Token, accompagné du texte saisi par l'utilisateur.

POST/v5/captcha

Paramètres

Le corps de la requête doit être en JSON :

Paramètre	Requis	Description
token	Oui	Jeton issu de l'en-tête X-Captcha-Token
answer	Oui	Texte saisi par l'utilisateur. Insensible à la casse, espaces ignorés

Champs de réponse

Champ	Type	Description
valid	boolean	true si la réponse correspond
reason	string	Motif du rejet — absent lorsque valid vaut true

Motifs de rejet

Motif	Signification
wrong	La réponse ne correspond pas à l'image
expired	Le jeton a plus de 5 minutes
used	Le jeton a déjà été consommé — chacun ne sert qu'une seule fois
invalid	Le jeton est malformé

Exemples de code

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "token": "eyJ...",
    "answer": "a4Kf2p"
  }' \
  "https://api.sylvain.sh/v5/captcha"

Essayer

POSThttps://api.sylvain.sh/v5/captcha

token*

answer*

Gestion des erreurs

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

Message d'erreur	Description
Please provide a token (?token={token})	Le token est manquant
Please provide an answer (&answer={answer})	La answer est manquante

Endpoints associés

• GET /v5/captcha - Générer un captcha en mode challenge
• GET /v5/pow - Preuve de travail, l'alternative recommandée