DokumentationProdukteShellBaseSitzungs-APISitzungs-API V1
Kommandos einer Sitzung
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Was in dieser Sitzung getippt wurde — mit Ausgabe und Urteil.
Ein eigener Scope, weil es ein eigener Vertrauensschritt ist: die Liste der Sitzungen sagt, dass jemand verbunden war; diese Liste sagt, was er getan hat.
GET https://sessions.api.shellbase.artim-industries.com/v1/sessions/{id}/commands
| Methode | GET |
| Basis | sessions.api.shellbase.artim-industries.com/v1 |
| Scope | sb.sessions.commands:read |
| Antwort | 200 |
| Zugang | Developer Mitgliedschaft |
| Auth | Authorization: Bearer sbapi_… |
Parameter
| Parameter | Ort | Typ | Pflicht | Bedeutung |
|---|---|---|---|---|
id | Pfad | string | ja | Kennung der Sitzung. |
limit | Query | integer | nein | Einträge je Seite, 1–200. Standard 50. |
offset | Query | integer | nein | Wie viele Einträge übersprungen werden. Standard 0. |
Anfrage
curl "https://sessions.api.shellbase.artim-industries.com/v1/sessions/{id}/commands?limit=50&offset=0" \
-H "Authorization: Bearer sbapi_…"
Antwort
Antwortrahmen
Diese Antwort ist blätterbar und trägt immer denselben Rahmen:
| Feld | Typ | Bedeutung |
|---|---|---|
data | array | Die Einträge dieser Seite. |
total | integer | Wie viele Einträge es insgesamt gibt. |
limit | integer | Die angefragte Seitengröße. |
offset | integer | Wie viele Einträge übersprungen wurden. |
Die Felder unten beschreiben einen Eintrag in data.
| Feld | Typ | Bedeutung |
|---|---|---|
command | string | Das Kommando, wie eingegeben. |
status | string | allowed oder blocked. |
returnCode | integer | Rückgabewert — null, wenn abgewiesen. |
cwd | string | Arbeitsverzeichnis. |
time | string | Zeitpunkt. |
response | string | Ausgabe, gekürzt. |
{
"data": [
{ "command": "systemctl status nginx", "status": "allowed", "returnCode": 0, "cwd": "/root", "time": "10:01" },
{ "command": "rm -rf /", "status": "blocked", "returnCode": null, "time": "10:02" }
],
"total": 14, "limit": 50, "offset": 0
}
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.