Richtlinie lesen

Eine einzelne Richtlinie mit allen Regeln.

GET https://policies.api.shellbase.artim-industries.com/v1/policies/{id}


Methode	`GET`
Basis	`policies.api.shellbase.artim-industries.com/v1`
Scope	`sb.policies:read`
Antwort	`200`
Zugang	Developer Mitgliedschaft
Auth	`Authorization: Bearer sbapi_…`

Parameter

Parameter	Ort	Typ	Pflicht	Bedeutung
`id`	Pfad	`string`	ja	Kennung der Richtlinie.

curl "https://policies.api.shellbase.artim-industries.com/v1/policies/{id}" \
  -H "Authorization: Bearer sbapi_…"

{ "id": "…", "name": "Kein rm -rf", "mode": "blacklist", "blockedCommands": ["rm -rf /"], "enabled": true }

Status	`code`	Wann
`401`	`invalid_token`	Bearer fehlt, ist unbekannt oder abgelaufen. Verlängern über `https://api.artim-industries.com/v1/oauth/token`.
`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.
`422`	`invalid_request`	Ein Parameter hat den falschen Typ oder liegt außerhalb des erlaubten Bereichs.
`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.