自定义 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 永远不会显示在公开的投票页面上。