La API di DeluxHost: automatizza server, fatture e attacchi con un token

Tutto quello che fai nel pannello, a un certo punto, vorresti farlo da uno script: riavviare un server quando il monitoraggio lo vede bloccato, mandare in Grafana il traffico anti-DDoS, scaricare le fatture del mese nella cartella del commercialista. Per questo c'è la API di DeluxHost.

Cosa puoi fare

La API copre gran parte di quello che trovi nel pannello. Qualche esempio:

Servizi e server: elenco dei servizi, stato, utilizzo e metriche, avvio, riavvio e spegnimento, storico delle operazioni; e per i server anche reverse DNS, ISO, rescue e backup.
Anti-DDoS: traffico pulito e scartato, storico degli attacchi con il dettaglio per porta, creazione ed eliminazione delle regole.
Fatture: elenco, dettaglio, pagamenti e PDF.
Storage Box: stato, utilizzo, IP autorizzati, chiavi SSH e snapshot.
Ticket e notifiche: un flusso di eventi dell'account (un servizio attivato, una fattura emessa, un pagamento non riuscito) da interrogare invece di confrontare tu le liste.

Il riferimento completo, con ogni endpoint, i permessi richiesti e un pannello per provare le chiamate, è su api.deluxhost.net/v1/docs.

La documentazione interattiva della API

Token con permessi precisi

La API non usa la tua password ma un token che crei tu nel pannello: Profile, scheda API tokens, Create token. Gli dai un nome, una scadenza (30 giorni, 90 giorni, un anno o mai) e soprattutto i permessi: solo quelli che servono allo strumento che lo userà.

I token API nel pannello, ciascuno con i suoi permessi

Un esportatore per Grafana avrà solo services:read e firewall:read; un bot che riavvia i server anche services:power, e nient'altro. Le operazioni più delicate, come console, reinstallazione, ripristino dei backup o ordini e pagamenti, richiedono permessi separati che devi spuntare apposta. Cambiare email, password e 2FA o creare altri token si fa invece solo dal pannello.

Il token viene mostrato una volta sola: copialo nel tuo strumento o in un password manager. Per ogni token vedi il prefisso, i permessi e quando è stato usato l'ultima volta; con Revoke smette di funzionare all'istante. Ogni creazione e revoca ti arriva anche per email.

Un esempio

Elencare i servizi:

bash

curl https://api.deluxhost.net/v1/services \
  -H "Authorization: Bearer $DELUXHOST_TOKEN"

Riavviare un server (con il permesso services:power):

bash

curl -X POST https://api.deluxhost.net/v1/services/<id>/power \
  -H "Authorization: Bearer $DELUXHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"restart"}'

La risposta conferma che l'operazione è stata accettata e restituisce l'ID del task, con cui controlli quando è finita.

Qualche buona regola

Un token per strumento: se uno trapela lo revochi senza fermare gli altri.
Meno permessi possibile e una scadenza quando lo strumento lo consente.
Mai nel codice pubblico, in un ticket o in una chat. La API va chiamata dal tuo backend, non dal JavaScript di una pagina web.
Rispetta i limiti: ogni risposta indica quante richieste ti restano nel minuto.