Sitzung lesen

Eine Sitzung samt der Zahl ihrer Kommandos.

GET https://sessions.api.shellbase.artim-industries.com/v1/sessions/{id}


Methode	`GET`
Basis	`sessions.api.shellbase.artim-industries.com/v1`
Scope	`sb.sessions:read`
Antwort	`200`
Zugang	Developer Mitgliedschaft
Auth	`Authorization: Bearer sbapi_…`

Parameter

Parameter	Ort	Typ	Pflicht	Bedeutung
`id`	Pfad	`string`	ja	Kennung der Sitzung.

curl "https://sessions.api.shellbase.artim-industries.com/v1/sessions/{id}" \
  -H "Authorization: Bearer sbapi_…"

Feld	Typ	Bedeutung
`id`	`string`	Kennung der Sitzung.
`server`	`string`	Name des Servers.
`active`	`boolean`	Ob sie noch offen ist.
`commandCount`	`integer`	Wie viele Kommandos gelaufen sind.

{ "id": "…", "server": "web-01", "active": false, "duration": "23m", "commandCount": 14 }

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.

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.