Public Pages DE

Öffentliche Server-Seiten

🌐 English · Deutsch

/public/<guildId> ist eine öffentliche Schaufenster-Seite für einen Server — erreichbar ohne Login. Eine Community kann sich damit (Regeln, Links, Leaderboards, was auch immer der Owner schreibt) auf einer sauberen Seite unter der Dashboard-Domain des Bots präsentieren.

Funktionsweise — Opt-in per Konvention

Das Gateway liefert keine anonymen Server-Daten, daher rendert die Seite ausschließlich Inhalte, die der Bot-Owner explizit veröffentlicht hat — über Custom Pages mit Sichtbarkeit öffentlich. Eine Gilde meldet sich rein per Slug-Konvention an:

Slug	Rolle
guild-<guildId>	Die Schaufenster-Seite selbst — ihr Titel und Markdown-Inhalt werden zum Seiteninhalt.
guild-<guildId>-*	Zusätzliche öffentliche Seiten (z. B. guild-123-leaderboard) — sie werden unter dem Schaufenster als Unterseiten gelistet.

Beispiel: Um eine öffentliche Seite für Gilde 123456789 zu aktivieren, lege unter /pages eine öffentliche Custom Page mit dem Slug guild-123456789 an. Fertig — /public/123456789 ist sofort live.

Existiert keine solche Seite, sehen Besucher einen freundlichen Leerzustand; eingeloggte Benutzer sehen zusätzlich den exakten Opt-in-Slug (anonymen Besuchern werden keine Interna angezeigt).

Sicherheitsmodell

• Nur öffentliche Reads. Anonyme Anfragen holen nichts Auth-Geschütztes — nur die öffentliche Seitenliste und öffentliche Seiteninhalte. Die Sichtbarkeit wird vor dem Rendern am vollständigen Datensatz erneut geprüft (Defence in Depth).
• Sicheres Markdown. Inhalte laufen durch denselben XSS-sicheren Markdown-Renderer wie alle Custom Pages — Roh-HTML wird escaped.
• Mitglieder-Anreicherung. Ist der Besucher eingeloggt und Mitglied der Gilde, zeigt die Seite zusätzlich Live-Servername, -Icon und -Mitgliederzahl (via core.guild_detail, Mitgliedschaft wird vom Gateway erzwungen). Anonyme Besucher bekommen diesen Block schlicht nicht.

Verwandte Seiten

• Custom Pages — die Seiten anlegen, die das Ganze speisen
• Authentifizierung — öffentliche vs. mitglieder-geschützte Daten
• API & Gateway — die pages.*-Methoden