DokumentationProdukteShellBaseServer-API
Server-API V1
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.
https://servers.api.shellbase.artim-industries.com/v1
Endpoints
| Request | Methode | Pfad | Scope | Zugang |
|---|---|---|---|---|
| Überblick | GET | / | sb.servers:read | Programm |
| Server auflisten | GET | /servers | sb.servers:read | Programm |
| Server lesen | GET | /servers/{id} | sb.servers:read | Programm |
| Marken auflisten | GET | /tags | sb.servers:read | Programm |
| Server anlegen | POST | /servers | sb.servers:write | Programm |
| Server bearbeiten | PATCH | /servers/{id} | sb.servers:update | Programm |
| Server löschen | DELETE | /servers/{id} | sb.servers:delete | Programm |
| Inventar abgleichen | POST | /servers/refresh | sb.servers.inventory:execute | Programm |
Jeder Request hat seine eigene Seite mit Parametern, Antwortstruktur, Beispiel, Fehlern und Rate Limits.
Scopes
sb.servers:readsb.servers:writesb.servers:updatesb.servers:deletesb.servers.inventory:execute