API — Übersicht & Auth

Die BlackProtect API ist eine REST API. Alle Endpunkte geben JSON zurück.

Basis-URL

https://bp.tuerkmen.dev/proxy

Authentifizierung

Alle Endpunkte erfordern einen gültigen JWT als Bearer Token:

Authorization: Bearer <dein-token>

Den Token erhältst du nach dem Discord-Login aus dem Dashboard (gespeichert unter bp:token in localStorage).

JWT-Claims

Claim	Typ	Inhalt
id	string	Discord Snowflake ID
username	string	Discord-Username
role	string	admin oder user
exp	number	Ablaufzeitpunkt (Unix)

Fehler-Antworten

Status	Bedeutung
401	Token fehlt oder ungültig
403	Keine Berechtigung für diese Ressource
404	Ressource nicht gefunden
502	Filter-Knoten nicht erreichbar