Zum Inhalt springen

Eigene API-Prüfung

Füge einer Umfrage die Bedingung „Eigene API-Prüfung“ hinzu, und Polls fragt deinen Server, bevor eine Stimme zählt.

Die Anfrage

Polls sendet eine GET-Anfrage an deine URL. [USERID] und [GUILDID] werden durch die ID der abstimmenden Person und des Servers ersetzt.

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

Die Antwort

Antworte mit Status 200 und JSON. Um die Stimme zu erlauben:

{"success": true}

Um sie abzulehnen, optional mit einem Grund für das Mitglied (bis zu 300 Zeichen):

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

Regeln

  • Nur https://-URLs, die auf öffentliche Adressen zeigen, werden aufgerufen. Weiterleitungen werden nicht verfolgt.
  • Dein Endpunkt hat etwa 4,5 Sekunden Zeit zu antworten.
  • Antwortet er mit 404, 5xx oder gar nicht, pausiert Polls die Aufrufe für eine Minute.
  • Die URL wird nie auf der öffentlichen Umfrage-Seite angezeigt.