Inventar abgleichen

Fragt Zustand und Kennzahlen aller Server neu ab.

Der Aufruf dauert so lange, wie die Server brauchen. Für ein Dashboard genügt einer je Minute — ShellBase gleicht ohnehin von selbst ab.

POST https://servers.api.shellbase.artim-industries.com/v1/servers/refresh


Methode	`POST`
Basis	`servers.api.shellbase.artim-industries.com/v1`
Scope	`sb.servers.inventory:execute`
Antwort	`200`
Zugang	Developer Mitgliedschaft
Auth	`Authorization: Bearer sbapi_…`

Parameter

Dieser Endpunkt nimmt keine Parameter.

Dieser Endpunkt braucht keinen Körper.

curl -X POST "https://servers.api.shellbase.artim-industries.com/v1/servers/refresh" \
  -H "Authorization: Bearer sbapi_…"

Feld	Typ	Bedeutung
`refreshed`	`integer`	Wie viele Server abgefragt wurden.
`online`	`integer`	Wie viele davon geantwortet haben.

{ "refreshed": 40, "online": 30 }

Status	`code`	Wann
`400`	`invalid_request`	Ein Pflichtfeld fehlt, ein Typ passt nicht, oder ein Verweis zeigt auf etwas, das es hier nicht gibt.
`401`	`invalid_token`	Bearer fehlt, ist unbekannt oder abgelaufen.
`403`	`missing_scope`	Das Token trägt den Scope dieses Endpunkts nicht.
`404`	`not_found`	Der Eintrag gehört nicht zum freigegebenen Team — oder die Anfrage kam auf der falschen Subdomain an.
`409`	`conflict`	Der Zustand verbietet die Änderung — der Fehlerkörper nennt den Grund.
`429`	`rate_limited`	Kontingent erschöpft, siehe `Retry-After`.

Jede Fehlerantwort trägt dieselbe Hülle: error.code benennt den Fehler, error.message sagt in einem Satz, was fehlt.

Das Limit gilt pro Team, nicht pro Token.

Zugang	Produktion	Sandbox
Hobby	60 Anfragen/Minute	ohne Limit
Developer Mitgliedschaft	10.000 Anfragen/Minute	ohne Limit

Bei 429 sagt der Retry-After-Header, wie lange du warten sollst.