Elenco dei siti

Restituisce i siti con hosting attivo accessibili alla chiave, con versione PHP e spazio disco.

• Metodo: GET
• Indirizzo: https://console.icbs.it/api/v1/hosting
• Permesso: Hosting — lettura

Parametri

Nessuno.

Esempio di richiesta

curl -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/hosting

Esempio di risposta

{
  "data": [
    {
      "hostname": "esempio.it",
      "phpVersion": "8.3",
      "status": "active",
      "diskQuotaGb": 10,
      "diskUsedBytes": 2147483648
    },
    {
      "hostname": "altro-esempio.com",
      "phpVersion": "8.2",
      "status": "active",
      "diskQuotaGb": 5,
      "diskUsedBytes": null
    }
  ]
}

Campi della risposta

Campo	Descrizione
hostname	Il nome del sito, da usare in Dettaglio di un sito.
phpVersion	Versione PHP attiva, null se non impostata.
status	active o inactive.
diskQuotaGb	Spazio assegnato in GB, null se non è previsto un limite.
diskUsedBytes	Spazio occupato in byte, null se non è ancora stata rilevata una misurazione.

Lo spazio occupato viene rilevato periodicamente, non a ogni chiamata: è normale che rifletta la situazione di poco tempo prima, e che sia null su un sito appena creato.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Hosting — lettura.
429	Superato il limite di richieste.

L'elenco contiene solo i siti con hosting attivo: un dominio registrato ma senza hosting compare in Elenco dei domini e non qui.