Creare un sottodominio

Crea un sottodominio con hosting: aggiunge il record DNS e prepara il sito sul server.

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

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
hostname	indirizzo	sì	Il dominio principale, per esempio esempio.it.
label	corpo	sì	La parte prima del dominio: blog per blog.esempio.it.
phpVersion	corpo	no	Versione PHP iniziale. Predefinita: quella consigliata.
phpIni	corpo	no	Valori di configurazione PHP iniziali.
enableMysql	corpo	no	true abilita i database sul sottodominio.
enableEmail	corpo	no	true abilita la posta sul sottodominio.

Esempio di richiesta

curl -X POST \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"blog","phpVersion":"8.3","enableMysql":true}' \
  https://console.icbs.it/api/v1/hosting/esempio.it/subdomains

Esempio di risposta

{
  "hostname": "blog.esempio.it",
  "job": {
    "id": "wj_8f3k2m",
    "hostname": "blog.esempio.it",
    "type": "web.subdomain_provision",
    "status": "pending",
    "error": null,
    "createdAt": "2026-10-01T10:00:00.000Z",
    "updatedAt": "2026-10-01T10:00:00.000Z"
  }
}

Il sottodominio compare subito nell'elenco, ma risponde solo quando l'operazione è done. Il certificato SSL viene emesso al termine.

Possibili errori

Codice	Causa
400	Etichetta non valida o riservata, oppure raggiunto il numero massimo di sottodomini.
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Hosting — configurazione siti.
404	Il dominio non esiste o la chiave non vi ha accesso.
409	Il sottodominio esiste già, oppure un'altra operazione è in corso sul sito.
429	Superato il limite di richieste.