compute
POST /v1/compute/terminal
Turn the web terminal on — mint the organisation's terminal key.
Autentizace
Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění billing.payment.manage; klíč bez něj je odmítnut s kódem 403, nikoli 404.
Sem patří ID vaší organizace
Tento koncový bod přijímá org_id jako parametr dotazu. Pokud ho vynecháte, volání pokryje celý podstrom vašeho nájemce; jeho odesláním volání zúžíte na jednu organizaci.
ID vaší organizace najdete na obrazovce API klíčů ve vašem přehledu, hned vedle samotného klíče. Je to stále stejné ID v každém volání, které provedete.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X POST https://api.zinndigital.com/v1/compute/terminal \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
Mints one ed25519 key for the organisation. ⛔ The private half is written to our secret store and never returned by any API; the public half is registered as one of the organisation's SSH keys, so every machine ordered afterwards carries it from first boot. Idempotent. Audit-logged. Requires billing.payment.manage — the same authority that registers an SSH key.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
org_id (query) | Uuid | Ne | — |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
enabled | boolean | Ano | — |
public_key | string | Ano | The one line to add to authorized_keys on a machine built before the terminal was turned on. Public by definition — not a secret. "" when the terminal was never on. |
fingerprint | string | Ano | — |
Chyby, které může tento koncový bod vrátit
401 · 403 · 422 · 429 · 503