DokumentationProdukteShellBase
Relay-API
Ein Relay ist der Agent, über den ShellBase Server erreicht, die nicht im Netz stehen. Diese API legt Relays an, pflegt sie und zeigt den Verkehr, der durch sie läuft.
Das Agent-Token ist ein Zugangsgeheimnis: wer es hat, meldet einen eigenen Agenten an. Es steht in keiner Liste, sein Abruf ist ein Enterprise-Scope und wird protokolliert.
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 | relays.api.shellbase.artim-industries.com/v1 | 8 |
Freischalten
- In der Konsole unter APIs die Relay 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.