Engagerly 2.0 · Ein klarer Ablauf für deine Discord-Community
Entwickler-API

Verbinde Engagerly mit deinen eigenen Systemen

Lies und ändere Kontostände von Mitgliedern und vergib oder entferne Rollen aus deinen Apps, Spielen und Shops – mit eingeschränkten API-Schlüsseln und vollständigem Audit-Log.

API-Doku lesen

Premium+Mit Premium und Ultimate lassen sich API-Schlüssel im Dashboard erstellen

REQUESTEinem Mitglied bei einer Bestellung 500 Punkte gutschreiben.

curl -X POST "$API_BASE/v2/open/guilds/$GUILD_ID/points/adjust" \
  -H "X-API-Key: $ENGAGERLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123456789012345678",
    "type": "add",
    "amount": 500,
    "note": "Order #1042 bonus",
    "ref": "order-1042"
  }'
USE CASES

Was Teams damit bauen

  • Belohnungen im Spiel

    Vergib Punkte, wenn Spieler in deinem Spiel Erfolge freischalten.

  • Shop-Boni

    Belohne Kunden bei einer Bestellung mit Punkten oder einer VIP-Rolle.

  • Event-Check-ins

    Gib allen, die an einem Live-Event oder Webinar teilgenommen haben, eine Rolle.

ENDPOINTS

Vier Endpunkte, eingegrenzt nach Berechtigung.

Jeder Schlüssel ist auf den Berechtigungsumfang beschränkt, den du ihm gibst.

  • GET
    /v2/open/guilds/{guild_id}/points/balance/{user_id}

    Den Kontostand eines Mitglieds in jeder Währung des Servers abrufen.

    points:read
  • POST
    /v2/open/guilds/{guild_id}/points/adjust

    Punkte für ein Mitglied gutschreiben oder abziehen, optional mit Notiz und eigener Referenz-ID.

    points:write
  • POST
    /v2/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    Einem Mitglied eine Discord-Rolle geben.

    roles:write
  • DELETE
    /v2/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    Einem Mitglied eine Discord-Rolle entziehen.

    roles:write
KEYS & LIMITS

Schlüssel und Limits

  • Erstelle API-Schlüssel im Dashboard mit Premium oder Ultimate – bis zu 10 pro Server.
  • Sende den Schlüssel im Header X-API-Key. Jeder Schlüssel funktioniert nur für seinen eigenen Server.
  • Gib einem Schlüssel nur den Berechtigungsumfang, den er braucht: points:read, points:write oder roles:write.
  • Optional kannst du für jeden Schlüssel ein Ablaufdatum und eine IP-Allowlist festlegen.
  • Jeder Schlüssel erlaubt 120 Lese- und 60 Schreibzugriffe pro Minute, jeder Server 200 Aufrufe pro Minute, und jeder Aufruf landet im Audit-Log des Schlüssels.

Willst du sehen, was als Nächstes für die API kommt?

Neue Endpunkte werden zuerst auf dem offiziellen Discord-Server besprochen.

Unserem offiziellen Discord-Server beitreten
READY WHEN YOU ARE

Bereit, dass Beteiligung
von selbst läuft?

Als Mitglied ausprobieren