Accedi alla Console ICBS
Overview
Generale
Sicurezza e account
Domini
Zone DNS
DNS dinamico
Record DNS
Monitoring
Funzionalità
Database
Web hosting
Web server
Account email
Account FTP
Supporto
API
  • Autenticazione
  • Verificare la chiave
Domini
DNS
  • Elenco dei record
  • Creare un record
  • Modificare un record
  • Eliminare un record
  • Creare la zona
  • Eliminare la zona
  • Applicare un template
  • Elenco dei template
  • Esportare la zona
  • Leggere il record SOA
  • Modificare il record SOA
  • Stato DNSSEC
  • Attivare o disattivare DNSSEC
Hosting
Email
FTP
Database
Monitoraggio
Gruppi
Ordini

API / DNS

Creare la zona

Ultimo aggiornamento: 06/08/2026, 21:11

Note legali·Privacy·Policy di sistema·Termini e condizioni
Documentazione

Attiva la gestione DNS di un dominio, creando la zona che conterrà i record.

Senza questa chiamata l'automazione di un dominio nuovo si interrompe: si possono gestire i record solo se la zona esiste già.

  • Metodo: POST
  • Indirizzo: https://console.icbs.it/api/v1/domains/{dominio}/dns
  • Permesso: DNS — creazione, modifica ed eliminazione record

Parametri

ParametroPosizioneObbligatorioDescrizione
dominioindirizzosìIl nome a dominio, per esempio esempio.it.

Nessun corpo della richiesta.

Esempio di richiesta

curl -X POST \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/domains/esempio.it/dns

Esempio di risposta

{ "domain": "esempio.it", "created": true }

Cosa fare subito dopo

La zona nasce con la configurazione minima. Per popolarla in una sola chiamata invece di crearne i record uno per uno, usa Applicare un template.

Possibili errori

CodiceCausa
400Nome a dominio non valido, oppure la zona esiste già.
401Chiave assente, non valida, scaduta o revocata.
403Alla chiave manca il permesso di scrittura DNS.
404Il dominio non esiste o la chiave non vi ha accesso.
429Superato il limite di richieste.