Aller au contenu
Accueil moxon

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.

posthttps://api.moxon.dev/v6/captcha
Essayerpost/v6/captcha

Paramètres

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

  • tokenstringrequis

    Jeton issu de l'en-tête X-Captcha-Token

  • answerstringrequis

    Texte saisi par l'utilisateur. Insensible à la casse, espaces ignorés

Champs de réponse

  • validboolean

    true si la réponse correspond

  • reasonstring

    Motif du rejet — absent lorsque valid vaut true

Motifs de rejet

MotifSignification
wrongLa réponse ne correspond pas à l'image
expiredLe jeton a plus de 5 minutes
usedLe jeton a déjà été consommé — chacun ne sert qu'une seule fois
invalidLe jeton est malformé

Exemples de code

Gestion des erreurs

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

  • 400Please provide a token (?token={token})Le token est manquant
  • 400Please provide an answer (&answer={answer})La answer est manquante
  • get/v6/captcha - Générer un captcha en mode challenge
  • get/v6/pow - Preuve de travail, l'alternative recommandée