Entwickler

API-Referenz

Eine lesefokussierte REST-API für eigene Integrationen. Die geplante Basis-URL ist https://api.lnrs.dev. Geschützte Routen authentifizieren sich mit einem Bearer-Token, begrenzt auf 120/min.

Noch nicht verfügbar

Keiner der unten stehenden Endpunkte ist live, und es werden noch keine Keys ausgegeben. Diese Seite dokumentiert die geplante Form, damit du bereits dagegen entwickeln kannst. Trag dich in die Warteliste ein, wir melden uns, sobald es startet.

Authentifizierung

Authorization-Header

curl https://api.lnrs.dev/v1/stats \
  -H "Authorization: Bearer lnrs_sk_live_..."

GET/v1/health GeplantÖffentlich

Health

Öffentlicher Health-Check ohne Authentifizierung, gedacht für Statusprüfungen und Uptime-Monitoring.

Anfrage

curl https://api.lnrs.dev/v1/health \
  -H "Accept: application/json"

200 · Antwort

{
  "status": "operational",
  "uptime": 1209600,
  "shards": 1,
  "version": "3.0.0"
}

GET/v1/stats Geplant Bearer

Globale Statistik

Aggregierte Zahlen über alle Shards hinweg.

Anfrage

curl https://api.lnrs.dev/v1/stats \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Antwort

{
  "guilds": 4021,
  "users": 812043,
  "channels": 58210,
  "commandsRun": 9847123
}

GET/v1/guilds/{id} Geplant Bearer

Server-Übersicht

Konfigurationsübersicht und letzte Aktivität für einen Server, den du verwaltest.

Parameter

idsnowflakePFLICHTThe Discord guild ID.

Anfrage

curl https://api.lnrs.dev/v1/guilds/927174149873795122 \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Antwort

{
  "id": "927174149873795122",
  "name": "Lunaris HQ",
  "memberCount": 2681,
  "modules": { "leveling": true, "tickets": true },
  "prefix": "l?"
}

GET/v1/guilds/{id}/leaderboard Geplant Bearer

XP-Bestenliste

Top-Mitglieder sortiert nach XP.

Parameter

idsnowflakePFLICHTThe Discord guild ID.

limitintegerRows to return (1–100, default 10).

Anfrage

curl https://api.lnrs.dev/v1/guilds/927174149873795122/leaderboard \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Antwort

{
  "leaderboard": [
    { "userId": "712989...", "level": 42, "xp": 176400, "rank": 1 },
    { "userId": "548102...", "level": 39, "xp": 152100, "rank": 2 }
  ]
}

GET/v1/guilds/{id}/cases Geplant Bearer

Moderationsfälle

Letzte Moderationsfälle für einen Server.

Parameter

idsnowflakePFLICHTThe Discord guild ID.

Anfrage

curl https://api.lnrs.dev/v1/guilds/927174149873795122/cases \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Antwort

{
  "cases": [
    { "caseId": 184, "type": "ban", "userId": "...", "moderatorId": "...", "reason": "raiding" }
  ]
}

Der API-Warteliste beitreten

Melde dich mit Discord an, um dich für die Warteliste einzutragen. Keys werden noch nicht ausgegeben, wir schreiben dir per DM, sobald die API live ist. Jede Anfrage wird von Hand geprüft, Keys sind standardmäßig nur lesend.

Mit Discord anmelden