Authentifizierung
Team-API-Schlüssel erstellen, verwenden und verstehen, was damit nicht erreichbar ist.
Authentifizierung
Die öffentliche API authentifiziert sich ausschließlich über Team-API-Schlüssel mit dem Präfix TP_.
Schlüssel erstellen
- Du brauchst die Berechtigung Superadmin.
- Gehe zu Administration → API-Schlüssel.
- Klicke auf Neuen API-Schlüssel erstellen.
- Optional: Beschreibung und ein Teammitglied als Kontext wählen.
- Nach dem Erstellen wird der Schlüssel nur einmal angezeigt – kopiere ihn sofort.
Ohne verknüpftes Mitglied gelten die Rechte des Team-Owners. Mit Mitglied folgen Modul- und Board-Rechte diesem Mitglied.
UI-Details: API-Schlüssel.
Einmalige Anzeige
Schließt du das Fenster, ohne den Schlüssel zu speichern, kannst du ihn nicht erneut einsehen. Du musst ihn dann rerollen.
Rerollen & Löschen
- Rerollen: erzeugt einen neuen Schlüssel; der alte wird sofort ungültig.
- Löschen: entfernt den Schlüssel dauerhaft.
Beides ist nur über die Web-App möglich – nicht über die API.
Anfrage mit curl
curl -X GET "https://api.team-panel.com/v1/team/get/{teamId}" \
-H "Authorization: Bearer TP_dein_schluessel"Ersetze {teamId} durch die ID deines Teams und TP_dein_schluessel durch deinen API-Schlüssel.
Nicht verfügbar mit API-Schlüsseln
Diese Bereiche brauchen Session-Auth, andere Secrets oder sind für Integratoren gesperrt:
| Bereich | Kurzgrund |
|---|---|
/v1/admin, /v1/auth, /v1/auth-client, /v1/account, /v1/checkout, /v1/notifications, /v1/internal | Session oder interne Secrets |
/v1/cdn, /v1/voice, /v1/bot, /v1/backupPanel | Infrastruktur / andere Auth |
/v1/gamePanel | Eigene Server-API, nicht in der öffentlichen OpenAPI |
/v1/profile, /v1/portalPage, /v1/logs, /v1/modules | Nur Session / UI |
/v1/team, /v1/team/create, /v1/team/last | User-bezogene Session-Routen |
/v1/team/invites, Owner-Routen, API-Key-CRUD | Sensible Team-Administration |
Schlüssel-Verwaltung (Erstellen, Rerollen, Löschen), Auth, Admin, Checkout und das Ein-/Ausschalten von Modulen sind über API-Schlüssel nicht möglich.