DokumentationProdukteShellBase

Sitzungs-API

3 min Lesezeit · zuletzt aktualisiert 18. August 2026

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.

Authentifiziert wird mit einem 30-Tage-Bearer (mcapi_…), den dein OAuth-Client über artim/dev bekommt — gebunden an ein Konto, eine Organisation und die Scopes deines Clients. Diese API antwortet ausschließlich unter ihrer eigenen Subdomain.

Versionen

VersionStandBasis-AdresseRequests
V1stabilsessions.api.shellbase.artim-industries.com/v17

Freischalten

  1. In der Konsole unter APIs die Sitzungs freischalten — der Verknüpfungs-Tab öffnet sich von selbst.
  2. Konto verknüpfen und die Organisation wählen, für die die API gelten soll.
  3. Unter OAuth › Clients einen Client für diese API anlegen; er trägt genau ihre Scopes.