Elenco dei sottodomini

Elenca i sottodomini con hosting di un sito. Si interroga sul dominio principale, non sul sottodominio.

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

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
hostname	indirizzo	sì	Il dominio principale, per esempio esempio.it.

Esempio di richiesta

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

Esempio di risposta

{
  "data": [
    {
      "hostname": "blog.esempio.it",
      "label": "blog",
      "status": "active",
      "hostingActive": true,
      "emailActive": false,
      "mysqlActive": true,
      "lastJob": { "id": "wj_8f3k2m", "status": "done", "error": null }
    }
  ]
}

Un sottodominio è a sua volta un sito: le altre chiamate di questa sezione funzionano anche con blog.esempio.it come hostname.

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.