Skip to main content
Mit der Public API liest und schreibst du SquadVault-Daten einer Organisation über API-Keys. Nutze sie für Skripte, Bots, Discord-Tooling und interne Integrationen.

​
Basis-URL

Alle Public-API-Endpunkte liegen unter /v1. Organisations-API-Keys funktionieren nur auf diesem versionierten Pfad. App-Proxy-Pfade ohne /v1 gehören zum SquadVault-Dashboard (Session-Auth) und sind nicht der Integrations-Contract. Produktive Integrationen sollten immer https://api.squadvault.xyz/v1 verwenden.

​
Was du tun kannst

Kalender, Aufgaben, Verfügbarkeit und die Discord-Verwaltung sind noch nicht Teil dieser Public API.

​
Organisations-ID

Der API-Key ist auf eine Organisation beschränkt, die meisten Operationen verlangen trotzdem die ID dieser Organisation. Sie muss zum Key passen. Fehlende oder abweichende IDs führen zu 400 invalidRequest oder 403 forbidden. Team-, Spieler- und Dokument-Update/Delete/Download leiten die Organisation aus der Resource-ID ab. Tryout-Get, -Update und -Convert tun das nicht — organizationId immer mitschicken.

​
Voraussetzungen

  1. Eine Organisation in einem Tarif, der API-Zugriff enthält.
  2. Ein Organisations-API-Key aus Integrationen → API-Keys.
  3. Berechtigungen auf dem Key, die zu den aufgerufenen Endpunkten passen.

​
Kurzes Beispiel

​
Weiter

Authentifizierung

Organisations-API-Keys bei jeder Anfrage mitsenden.

Berechtigungen

Key-Berechtigungen zu jedem Endpunkt passend setzen.