API – Einführung

SC-OrgaBase bietet eine öffentliche, versionierte API unter /api/v1 für externe Integrationen (Discord-Bots, Org-Webseiten, Tools). Sie gibt nur öffentliche Daten aus – niemals private Informationen.

Basis & Versionierung

• Basis-URL: /api/v1
• OpenAPI-Spezifikation: /api/v1/openapi.json
• Status: GET /api/v1/status (ohne Key)
• Breaking Changes nur mit neuer Version (v2, …); v1 bleibt stabil.

Endpunkte (Phase 1, lesend)

• GET /api/v1/status
• GET /api/v1/orgs · GET /api/v1/orgs/{slug}
• GET /api/v1/alliances · GET /api/v1/alliances/{slug}
• GET /api/v1/blueprints?search=&category=&active=

Antwortformat

Alle Antworten nutzen { success, data, meta } (Listen zusätzlich pagination). Fehler: { success:false, error:{ code, message, details } }.