DokumentationProdukteShellBaseSitzungs-API
Sitzungs-API V1
Hinter einer Sitzung steht eine echte SSH-Verbindung. Lesen darf jede Integration; öffnen, ausführen und beenden verlangen eine Enterprise-Mitgliedschaft — und auch dann gelten die Server-Berechtigungen des Kontos und die Richtlinien des Teams.
Eine Integration ist kein eigener Akteur: sie handelt für das Konto, an das ihr Token gebunden ist. Wo dieses Konto nicht hindarf, kommt auch die Anwendung nicht hin.
https://sessions.api.shellbase.artim-industries.com/v1
Endpoints
| Request | Methode | Pfad | Scope | Zugang |
|---|---|---|---|---|
| Überblick | GET | / | sb.sessions:read | Programm |
| Sitzungen auflisten | GET | /sessions | sb.sessions:read | Programm |
| Sitzung lesen | GET | /sessions/{id} | sb.sessions:read | Programm |
| Kommandos einer Sitzung | GET | /sessions/{id}/commands | sb.sessions.commands:read | Programm |
| Sitzung öffnen | POST | /servers/{id}/sessions | sb.sessions:write | Enterprise |
| Kommando ausführen | POST | /sessions/{id}/commands | sb.sessions.commands:execute | Enterprise |
| Sitzung beenden | DELETE | /sessions/{id} | sb.sessions:delete | Enterprise |
Jeder Request hat seine eigene Seite mit Parametern, Antwortstruktur, Beispiel, Fehlern und Rate Limits.
Scopes
sb.sessions:readsb.sessions.commands:readsb.sessions:writesb.sessions.commands:executesb.sessions:delete