DokumentationProdukteShellBaseTeam-APITeam-API V1
Kennwerte lesen
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Die Zahlen, die ShellBase auf seinem Überblick zeigt.
GET https://team.api.shellbase.artim-industries.com/v1/stats
| Methode | GET |
| Basis | team.api.shellbase.artim-industries.com/v1 |
| Scope | sb.team.stats:read |
| Antwort | 200 |
| Zugang | Developer Mitgliedschaft |
| Auth | Authorization: Bearer sbapi_… |
Parameter
Dieser Endpunkt nimmt keine Parameter.
Anfrage
curl "https://team.api.shellbase.artim-industries.com/v1/stats" \
-H "Authorization: Bearer sbapi_…"
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
totalServers | integer | Server insgesamt. |
onlineServers | integer | Erreichbare Server. |
activeSessions | integer | Offene Sitzungen. |
totalSessions | integer | Sitzungen insgesamt. |
blockedCommands | integer | Abgewiesene Kommandos. |
allowedCommands | integer | Zugelassene Kommandos. |
relays | integer | Relays. |
members | integer | Mitglieder. |
{
"totalServers": 40, "onlineServers": 30, "activeSessions": 9, "totalSessions": 60,
"blockedCommands": 27, "allowedCommands": 12813, "relays": 3, "members": 8
}
Fehler
| Status | code | Wann |
|---|---|---|
401 | invalid_token | Bearer fehlt, ist unbekannt oder abgelaufen. Verlängern über https://api.artim-industries.com/v1/oauth/token. |
403 | missing_scope | Das Token trägt den Scope dieses Endpunkts nicht. |
404 | not_found | Der Eintrag gehört nicht zum freigegebenen Team — oder die Anfrage kam auf der falschen Subdomain an. |
422 | invalid_request | Ein Parameter hat den falschen Typ oder liegt außerhalb des erlaubten Bereichs. |
429 | rate_limited | Kontingent erschöpft, siehe Retry-After. |
Jede Fehlerantwort trägt dieselbe Hülle: error.code benennt den Fehler, error.message sagt in einem Satz, was fehlt.
Rate Limits
Das Limit gilt pro Team, nicht pro Token.
| Zugang | Produktion | Sandbox |
|---|---|---|
| Hobby | 60 Anfragen/Minute | ohne Limit |
| Developer Mitgliedschaft | 10.000 Anfragen/Minute | ohne Limit |
Bei 429 sagt der Retry-After-Header, wie lange du warten sollst.