Fehler

Fehlerantworten verwenden einen JSON-Body mit einem error-Code-String, auf den du in Clients verzweigen kannst.

{
  "error": "forbidden"
}

Authentifizierung und Autorisierung

Status	`error`	Was du prüfen solltest
401	`unauthorized`	Ist der Header vorhanden? Nutzt du `x-api-key`?
401	`invalidApiKey`	Key korrekt kopiert? Nicht widerrufen oder abgelaufen?
403	`forbidden`	Passen Key-Berechtigungen und Organisation zur Anfrage?
403	`featureNotAvailable`	Enthält der Tarif diese Funktion (zum Beispiel Rocket-League-Tags oder API-Zugriff)?
429	`rateLimited`	Zu viele Requests mit diesem Key — kurz warten und erneut versuchen

Status	Häufige `error`-Werte
400	`invalidRequest`, `invalidStatus`, `alreadyConverted`, `playerCreateFailed`, `convertFailed`, `invalidPlayer`, `invalidTeam`, `invalidTeamRole`, `invalidFileType`, `fileTooLarge`, `unsupportedContentType`, `duplicateGame`, `invalidDiscordUserId`
404	`teamNotFound`, `playerNotFound`, `documentNotFound`, `notFound`
409	`discordUserIdTaken`, `alreadyApplied`
413	`payloadTooLarge`
500	`internalServerError`, `uploadUrlFailed`, `downloadUrlFailed`

Die genauen Codes hängen vom Endpunkt ab. Die operationsspezifischen Antworten findest du in der API-Referenz.

Prüfe, ob die Basis-URL https://api.squadvault.xyz/v1 ist.
Prüfe, ob die Organisations-ID im Pfad, Query oder Body zur Organisation des Keys passt. Tryout-Get/Update/Convert verlangen immer organizationId (?organizationId= bei GET, JSON-Body bei PATCH/POST).
Prüfe, ob der Key die unter Berechtigungen genannte Berechtigung hat.
Prüfe bei Uploads, ob contentType erlaubt ist und fileKey mit documents/{organizationId}/ beginnt.