DokumentationProdukteShellBase
Server-API
Die Server, auf die dein Team über ShellBase zugreift. Ein Zugangsgeheimnis (Passwort oder privater Schlüssel) darf hineingehen, kommt aber nie wieder heraus: es liegt verschlüsselt beim Produkt, und keine Antwort dieser API nennt es.
Schreibende Aufrufe verlangen dieselbe Berechtigung wie die Oberfläche: das Konto, an das dein Token gebunden ist, braucht im Team das Recht, Server zu verwalten.
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
| Version | Stand | Basis-Adresse | Requests |
|---|---|---|---|
| V1 | stabil | servers.api.shellbase.artim-industries.com/v1 | 8 |
Freischalten
- In der Konsole unter APIs die Server freischalten — der Verknüpfungs-Tab öffnet sich von selbst.
- Konto verknüpfen und die Organisation wählen, für die die API gelten soll.
- Unter OAuth › Clients einen Client für diese API anlegen; er trägt genau ihre Scopes.