Request Body

Responsecopy
{
  "verification_url": "https://…/verify/a1b2c3…",
  "token":            "a1b2c3d4e5f6…",
  "expires_at":       1700003600,
  "server_id":        "123456789012345678",  // null möglich
  "role_id":          "987654321098765432"   // null möglich
}

Beispiel

Node.js / fetchcopy
const res = await fetch(`${BASE_URL}/api/verify/create`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.API_KEY}`,
    'Content-Type':  'application/json'
  },
  body: JSON.stringify({ user_id: member.id })
});
const { verification_url } = await res.json();
// → Link per DM an den User schicken

cURLcopy
curl -X POST https://deine-domain.de/api/verify/create \
  -H "Authorization: Bearer DEIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"123456789012345678"}'

Responsecopy
{
  "token":            "a1b2c3…",
  "status":           "verified",  // "pending" | "verified" | "expired"
  "target_user_id":   "123456789012345678",
  "verified_user_id": "123456789012345678",
  "role_id":          "987654321098765432",
  "server_id":        "111222333444555666",
  "verified":         true,
  "verified_at":      1700000123,
  "expires_at":       1700003600,
  "email":            "user@example.com",  // null wenn scope nicht aktiv
  "guilds":           […]                 // null wenn scope nicht aktiv
}

Polling-Beispiel

Node.jscopy
async function pollVerify(token) {
  let tries = 0;
  return new Promise(resolve => {
    const iv = setInterval(async () => {
      if (++tries > 60) { clearInterval(iv); resolve(null); return; }
      const s = await fetch(`/api/verify/status/${token}`, {
        headers: { 'Authorization': `Bearer ${API_KEY}` }
      }).then(r => r.json());
      if (s.verified) { clearInterval(iv); resolve(s); }
    }, 5000);
  });
}

Response
{
  "server_id":  "123456789012345678",
  "role_id":    "987654321098765432",
  "label":      "Mein Server",
  "created_at": 1700000000,
  "last_used":  1700000500
}