自訂 API 檢查

為投票加入「自訂 API 檢查」條件後，Polls 會在計票前詢問你的伺服器。

請求

Polls 會向你的 URL 發送 GET 請求。[USERID] 和 [GUILDID] 會被替換為投票者與伺服器的 ID。

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

回應

以狀態碼 200 和 JSON 回應。允許投票：

{"success": true}

拒絕投票，可附上給成員的理由（最多 300 個字元）：

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

規則

• 只會呼叫指向公開位址的 https:// URL。不會跟隨重新導向。
• 你的端點大約有 4.5 秒可以回應。
• 如果回傳 404、5xx 或沒有回應，Polls 會暫停呼叫一分鐘。
• URL 永遠不會顯示在公開的投票頁面上。