✏️ Server Profile

Get Server Profile

OPTIMIERT: Retrieves the comprehensive profile for a server. Combines statistics from Message, Voice, Economy, Games & Community.

Optimierungen:

  • asyncio.gather() für parallele DB-Queries
  • only()/values() für minimale Datenübertragung
  • Batch-Queries statt einzelner Aufrufe

─── Warum hier Depends und validate_server_access stehen ───────────────

Sie standen bis 2026-09 NICHT hier, als einziger der 21 Endpunkte dieser Datei. Die Antwort traegt owner_id, die Abostufe und die interne Anpassungskonfiguration - jeder Unangemeldete konnte das fuer JEDE Server-ID abrufen, in der die Bot-Datenbank eine Zeile hat.

Der Weg dahin war vermutlich der Name: es gibt einen zweiten Endpunkt /public/servers/{id}/profile (serverinfo.py), und DER ist absichtlich offen - er liefert die oeffentliche Profilseite und nichts darueber hinaus. Dieser hier ist der Dashboard-Zwilling und war nie dafuer gedacht.

Beide Aufrufer im Frontend (ServerProfile.jsx:507, ServerProfileSettings.jsx:848) senden bereits einen Bearer-Token; fuer sie aendert sich nichts. Wer die oeffentlichen Daten will, nimmt weiterhin /public/servers/{id}/profile.

get/api/v1/servers/{server_id}/profile

Request

  • Base URL: https://api.notoq.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.notoq.xyz/api/v1/servers/{server_id}/profile
  • Auth: HTTP bearer

Path parameters

server_idstring required

Discord Server ID

Query parameters

langstring

Language (en-US or de)

Response

Successful Response

successboolean
server_idstring required
server_namestring required
icon_urlstring nullable required
owner_idstring nullable required
joined_atstring date-time nullable required
member_countinteger required
invite_linkstring nullable

Einladungslink des Servers, falls hinterlegt.

is_discoverableboolean

Hat der Ranking-Task den Server fuer die Liste freigegeben?

is_premiumboolean

Does the server have premium status?

is_professionalboolean

Is the server on the Professional tier?

planstring

Effective plan: free, premium or professional

tagsstring[]

Liste der aktiven Server-Tags

Changes

No recorded changes to this operation across all 1 revision of this API.