Vai al contenuto

-10% sul suo primo mese-10% 1° mese

Cosa vuole ospitare?

Gestisca i suoi server dai suoi strumenti

L'API dell'area clienti HelloServ apre i suoi server di gioco, i suoi VPS e i suoi server dedicati ai suoi script, al suo monitoraggio e alle sue dashboard: stato in diretta, avvio e arresto, reinstallazione, fatture e ordini di server pagati con il suo saldo.

terminal

$ curl https://panel.helloserv.fr/api/v1/services \
    -H "Authorization: Bearer $HELLOSERV_KEY"

{"data": [
  {"id": 48213, "name": "vps-prod-1", "type": "vps",
   "product": "vpsryzen", "status": "active",
   "primary_ip": "203.0.113.24",
   "actions": {"power": true, "reinstall": true}},
  {"id": 31877, "name": "survie-mc", "type": "game",
   "product": "minecraft", "status": "active",
   "primary_ip": "198.51.100.7",
   "actions": {"power": true, "reinstall": false}}
]}

Le azioni del pannello, dal suo codice

Un'API REST in JSON, su HTTPS. Ogni chiave riceve solo i permessi che lei le assegna.

  • Elencare i suoi servizi, le loro caratteristiche e i loro indirizzi IPGET /servicesLettura
  • Leggere lo stato di un server in direttaGET /services/{id}/statusLettura
  • Avviare, riavviare o arrestare un serverPOST /services/{id}/powerAlimentazione
  • Reinstallare un VPS o un server dedicatoPOST /services/{id}/reinstallReinstallazione
  • Scaricare le sue fatture in PDFGET /invoices/{number}/pdfLettura
  • Ordinare un server di gioco o un VPS con il suo saldoPOST /ordersOrdini

La documentazione descrive anche l'account e il saldo, il catalogo con i suoi prezzi, lo storico degli ordini, i limiti e i codici di errore.

Colleghi l'API agli strumenti che usa già

Poche righe di script bastano per la maggior parte degli usi. Negli esempi, $API vale https://panel.helloserv.fr/api/v1 e $HELLOSERV_KEY contiene la sua chiave.

Monitoraggio e dashboard

Mostri lo stato dei suoi server accanto al resto della sua infrastruttura, in Grafana, Uptime Kuma o nel suo strumento interno, e faccia scattare un avviso quando uno di essi si ferma.

supervision.sh

$ curl -s $API/services/48213/status \
    -H "Authorization: Bearer $HELLOSERV_KEY" | jq .data.power
"running"

Script, attività pianificate e deploy

Riavvii un server di gioco dopo un aggiornamento delle mod, reinstalli un VPS di prova dalla sua pipeline di integrazione o arresti un server di notte con un'attività pianificata.

deploy.yml

- name: Restart the server after the update
  run: >
    curl -X POST
    https://panel.helloserv.fr/api/v1/services/31877/power
    -H "Authorization: Bearer ${{ secrets.HELLOSERV_KEY }}"
    -H "Content-Type: application/json"
    -d '{"action": "restart"}'

Rivendita di server di gioco e VPS

Il suo negozio ordina il server con il suo saldo, al prezzo dell'area clienti, e lo consegna al suo cliente con il suo indirizzo IP. I prezzi li decide lei.

commande.sh

$ curl -X POST $API/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-1042" \
    -H "Content-Type: application/json" \
    -d '{"type": "minecraft", "offer_id": 2, "period": "monthly"}'

Agenzie e parchi di server

Gestisca i server dei suoi clienti dal suo strumento di gestione, con una chiave per progetto, e scarichi ogni mese le fatture in PDF per la sua contabilità.

factures.sh

$ curl -s "$API/invoices?per_page=100" \
    -H "Authorization: Bearer $HELLOSERV_KEY"
$ curl -o INV-2026-001234.pdf \
    $API/invoices/INV-2026-001234/pdf \
    -H "Authorization: Bearer $HELLOSERV_KEY"

Una chiave per strumento, con i suoi permessi e i suoi indirizzi

Le chiavi si creano nell'area clienti, in Il mio profilo e poi Sicurezza. La creazione richiede l'autenticazione a due fattori, e ogni chiave viene mostrata una sola volta.

Modulo di creazione di una chiave API nell'area clienti HelloServ, con i permessi Lettura, Alimentazione, Reinstallazione e Ordini e il campo degli indirizzi IP autorizzati
Creazione di una chiave: un nome, i permessi spuntati uno per uno e gli indirizzi IP autorizzati.
Due chiavi API nell'area clienti con i loro permessi, il loro ultimo utilizzo e i loro indirizzi IP autorizzati
Ogni chiave mostra i suoi permessi, il suo ultimo utilizzo e gli indirizzi da cui viene accettata.
Registro delle ultime chiamate all'API con il percorso, il codice di risposta, la chiave e l'indirizzo IP
Le ultime chiamate, rifiuti compresi: una chiamata da un indirizzo non autorizzato viene respinta e compare qui.

Ordini server con il saldo del suo account

Prezzi, IVA e fattura sono quelli dell'area clienti, e il server viene consegnato in 60 secondi.

  1. 01Ricarichi il saldo dall'area clienti e crei una chiave con il permesso Ordini, che non è mai spuntato di default.
  2. 02Legga il catalogo: le offerte in vendita e i loro prezzi per il suo account, IVA inclusa.
  3. 03Chieda un preventivo con dry_run: il prezzo esatto, senza ordinare nulla.
  4. 04Effettui l'ordine con una chiave di idempotenza: inviato due volte, viene registrato una sola volta.

terminal

$ curl -X POST https://panel.helloserv.fr/api/v1/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-7f3a9c21" \
    -H "Content-Type: application/json" \
    -d '{"type": "vpsintel", "offer_id": 3,
         "period": "monthly", "os": "debian12"}'

{"data": {
  "order": {"id": 42, "status": "paid"},
  "invoice": {"number": "INV-2026-001234", "status": "paid",
              "total": 9.60},
  "services": [{"id": 5678, "name": "vps-2", "status": "pending"}],
  "balance": 40.40
}}

Una documentazione con un esempio per ogni percorso

Ogni percorso ha la sua richiesta curl e la sua risposta. Il centro assistenza spiega passo per passo come creare una chiave, limitarla ai suoi indirizzi IP e fare un primo ordine.

Documentazione dell'API HelloServ aperta sulla sezione degli ordini

Domande sull'API

Centro assistenza Scrivici

L'API è a pagamento?
No. Fa parte dell'area clienti e funziona con tutti i suoi servizi.
Quali servizi si possono gestire?
I server di gioco, i VPS e i server dedicati. Stato e alimentazione funzionano per tutti e tre; la reinstallazione riguarda i VPS e i server dedicati.
Si può ordinare un server dedicato tramite l'API?
Per ora no: l'API ordina server di gioco e VPS. Un server dedicato si ordina dal sito o dall'area clienti.
Come si protegge una chiave?
Le dia solo i permessi utili e la limiti agli indirizzi IP dei suoi server, 20 al massimo. Se viene divulgata, la revochi dall'area clienti: viene rifiutata subito.
Ci sono dei limiti?
120 richieste al minuto per chiave e 10 ordini al giorno con la stessa chiave. Oltre, l'API risponde con il codice 429 e il tempo di attesa.

Il suo server è attivo 60 secondi dopo il pagamento.

Scelga l'offerta e paghi online: il server si installa da solo.