Dettaglio di un sito

Restituisce lo stato di un singolo sito: attivazione, PHP e occupazione disco.

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

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
hostname	indirizzo	sì	Il nome del sito, per esempio esempio.it.

Esempio di richiesta

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

Esempio di risposta

{
  "hostname": "esempio.it",
  "status": "active",
  "hostingActive": true,
  "php": {
    "version": "8.3",
    "enabled": true
  },
  "disk": {
    "usedBytes": 2147483648,
    "limitBytes": 10737418240,
    "syncedAt": "2026-08-05T04:00:00.000Z"
  }
}

Campi della risposta

Campo	Descrizione
status	active o inactive: stato del dominio.
hostingActive	Se il servizio di hosting è attivo sul dominio.
php.version	Versione PHP attiva, null se non impostata.
php.enabled	Se PHP è abilitato sul sito.
disk.usedBytes	Spazio occupato in byte, null se non ancora rilevato.
disk.limitBytes	Spazio assegnato in byte, 0 se non è previsto un limite.
disk.syncedAt	Quando è stata fatta l'ultima misurazione dello spazio occupato.

Il campo disk è null sui siti per cui non esistono né una quota né una misurazione.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Hosting — lettura.
404	Il sito non esiste o la chiave non vi ha accesso.
429	Superato il limite di richieste.