API VPS: automatizza i server cloud con JSON REST

Sì, l'API VPS è gratuita per tutti i membri. L'emissione di chiavi API e l'invio di richieste sono gratuiti, e i server e le opzioni creati con l'API vengono pagati agli stessi prezzi di quelli creati nel pannello di controllo. Qualsiasi membro che ha effettuato il primo pagamento può creare subito una chiave nella pagina delle chiavi API.

Dopo aver effettuato il primo pagamento, la pagina delle chiavi API (/api-key) si apre e puoi creare chiavi lì. Inserisci la chiave nell'intestazione Authorization di ogni richiesta utilizzando lo schema Bearer. La chiave sblocca l'intero account, quindi non inserirla nei repository di codice; conservala in variabili d'ambiente o in un archivio di segreti.

Puoi leggere il catalogo (GET /catalog), leggere l'elenco dei server e i dati di un singolo server (GET /servers, GET /servers/{id}), creare server (POST /servers), accendere, spegnere e riavviare (start, stop, reboot), rinnovare per un mese (renew) ed eliminare (DELETE /servers/{id}). Esempi di richieste e formato delle risposte sono nella documentazione API.

Con una chiave invii fino a 300 richieste al minuto. Superando il limite torna il codice di stato 429 con l'errore rate_limited, quindi basta fare in modo che lo script attenda un attimo e invii di nuovo. Le automazioni quotidiane, come verifica dell'elenco dei server e gestione dell'alimentazione, funzionano con margine entro questo limite. Non ci sono costi in base al numero di richieste.

Quando una richiesta POST /servers ha successo, il pagamento per il periodo di fatturazione scelto viene elaborato e il server viene creato. Il pagamento per un server che non riesce a creare viene restituito al credito del tuo account.

La risposta alla richiesta di creazione del server contiene una volta il valore root_password. Salvalo in un posto sicuro appena ricevi la risposta. Puoi rivederlo anche nel pannello per 7 giorni e, inviando anche il numero di una chiave SSH, accedi subito con la chiave senza password. Con il valore ipv4 della risposta avvii subito l'accesso SSH, comodo da collegare agli script di deploy.

Sì, inserendo nella richiesta di creazione del server il numero di una chiave SSH registrata nel valore ssh_key_id, quella chiave viene inserita nel nuovo server. Basta registrare la chiave una volta nella schermata Chiavi SSH del pannello; l'impronta è mostrata come con ssh-keygen, così capisci subito quale chiave è. Il numero della chiave lo imposti una volta e lo riusi.

Con qualsiasi linguaggio o strumento in grado di inviare richieste HTTP. Provi subito con curl e la chiami con lo stesso indirizzo e le stesse intestazioni da requests di Python, fetch di Node.js, i passaggi di script di GitLab CI e la funzione di richiesta HTTP di Terraform. Tutte le risposte sono in JSON, quindi i risultati sono facili da leggere.

Gli errori tornano con un codice di stato diverso da 2xx e un JSON con il valore error. I motivi sono distinti, come unauthorized se la chiave è sbagliata, bad_request se manca un valore, not_enough_balance se il saldo non basta e wrong_state se la richiesta non è compatibile con lo stato del server, così il programma gestisce ogni caso.

Sì, API e pannello gestiscono lo stesso account e gli stessi server. I server creati via API compaiono così come sono nell'elenco del pannello, dove puoi reinstallare il sistema operativo o controllare la password. Il limite di 10 server per account vale per entrambe le modalità. Anche mescolando lavoro manuale e lavoro dal codice, stato e date di addebito risultano sempre uguali.