{"openapi":"3.1.0","info":{"title":"RegyBot Public API","version":"1","description":"Lesende REST-API für Server-Betreiber. Authentifizierung: Authorization: Bearer rgy_… (Dashboard → Integrationen)."},"servers":[{"url":"https://api.regyhub.de"}],"paths":{"/api/v1/guilds/{guild_id}/server":{"get":{"tags":["public-api"],"summary":"Serverinfo und aktive Module","description":"Benötigt den Scope `server:read`.","operationId":"server_api_v1_guilds__guild_id__server_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"guild_id","in":"path","required":true,"schema":{"type":"integer","title":"Guild Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Server Api V1 Guilds  Guild Id  Server Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/guilds/{guild_id}/analytics":{"get":{"tags":["public-api"],"summary":"Tageswerte","description":"Benötigt den Scope `analytics:read`.","operationId":"analytics_api_v1_guilds__guild_id__analytics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"guild_id","in":"path","required":true,"schema":{"type":"integer","title":"Guild Id"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","pattern":"^(24h|7d|30d|90d)$","default":"7d","title":"Range"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Analytics Api V1 Guilds  Guild Id  Analytics Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/guilds/{guild_id}/events":{"get":{"tags":["public-api"],"summary":"Events, Scrims und Turniere","description":"Benötigt den Scope `events:read`.","operationId":"events_api_v1_guilds__guild_id__events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"guild_id","in":"path","required":true,"schema":{"type":"integer","title":"Guild Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Events Api V1 Guilds  Guild Id  Events Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/guilds/{guild_id}/calendar.ics":{"get":{"tags":["public-api"],"summary":"Kalender-Feed (iCal)","description":"Benötigt den Scope `calendar:read`.","operationId":"calendar_api_v1_guilds__guild_id__calendar_ics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"guild_id","in":"path","required":true,"schema":{"type":"integer","title":"Guild Id"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/guilds/{guild_id}/tickets/summary":{"get":{"tags":["public-api"],"summary":"Ticket-Zahlen","description":"Benötigt den Scope `tickets:read`.","operationId":"tickets_api_v1_guilds__guild_id__tickets_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"guild_id","in":"path","required":true,"schema":{"type":"integer","title":"Guild Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Tickets Api V1 Guilds  Guild Id  Tickets Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/guilds/{guild_id}/giveaways":{"get":{"tags":["public-api"],"summary":"Giveaways","description":"Benötigt den Scope `giveaways:read`.","operationId":"giveaways_api_v1_guilds__guild_id__giveaways_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"guild_id","in":"path","required":true,"schema":{"type":"integer","title":"Guild Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Giveaways Api V1 Guilds  Guild Id  Giveaways Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"securitySchemes":{"HTTPBearer":{"type":"http","description":"RegyBot-API-Schlüssel (rgy_…). Im Dashboard unter Integrationen erstellen.","scheme":"bearer"}},"schemas":{}},"x-scopes":{"server:read":"Serverinfo und aktive Module","analytics:read":"Tageswerte (Mitglieder, Nachrichten, Beitritte …)","events:read":"Events, Turniere und Scrims (nur öffentliche Angaben)","calendar:read":"Kalender-Feed (iCal) für Events, Turniere und Scrims","tickets:read":"Ticket-Zahlen (keine Inhalte, keine Nutzer)","giveaways:read":"Aktive und beendete Giveaways"}}