Aller au contenu

Vérification API personnalisée

Ajoute la condition « Vérification API personnalisée » à un sondage et Polls interroge ton serveur avant de compter un vote.

La requête

Polls envoie une requête GET à ton URL. [USERID] et [GUILDID] sont remplacés par l'ID du votant et du serveur.

GET https://api.example.com/can-vote?user=[USERID]&guild=[GUILDID]

La réponse

Réponds avec le statut 200 et du JSON. Pour autoriser le vote :

{"success": true}

Pour le refuser, avec une raison facultative pour le membre (jusqu'à 300 caractères) :

{"success": false, "message": "Link your account on example.com first."}

Règles

  • Seules les URL https:// pointant vers des adresses publiques sont appelées. Les redirections ne sont pas suivies.
  • Ton endpoint dispose d'environ 4,5 secondes pour répondre.
  • S'il répond 404, 5xx ou pas du tout, Polls suspend les appels pendant une minute.
  • L'URL n'est jamais affichée sur la page publique du sondage.