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
  • Elenco dei domini
  • Dettaglio di un dominio
  • Listino prezzi
  • Verificare la disponibilità
  • Domini in scadenza
  • Preventivo di rinnovo
  • Rinnovare un dominio
  • Modificare le impostazioni
  • Dati dell'intestatario
  • Modificare l'intestatario
  • Nameserver
  • Modificare i nameserver
  • Child nameserver
  • Creare o modificare un child nameserver
  • Eliminare un child nameserver
DNS
Hosting
Email
FTP
Database
Monitoraggio
Gruppi
Ordini

API / Domini

Modificare l'intestatario

Ultimo aggiornamento: 06/08/2026, 22:31

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

Aggiorna i dati di chi risulta intestatario del dominio.

  • Metodo: PATCH
  • Indirizzo: https://console.icbs.it/api/v1/domains/{dominio}/contacts
  • Permesso: Domini — modifica

Parametri

I campi vanno nel corpo della richiesta, con gli stessi nomi restituiti da Dati dell'intestatario: nome, cognome, azienda, email, telefono, indirizzo, città, CAP, paese.

Esempio di richiesta

curl -X PATCH \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"amministrazione@esempio.it","phone":"+39 02 7654321"}' \
  https://console.icbs.it/api/v1/domains/esempio.it/contacts

Esempio di risposta

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

Cambiare l'email fa ripartire la verifica

Su molte estensioni l'indirizzo dell'intestatario deve essere confermato: dopo la modifica arriva un messaggio di verifica, e finché non viene confermato il dominio può essere sospeso.

Non è una regola nostra, la impone il registro dell'estensione. Se cambi l'email da uno script, assicurati che la nuova casella sia raggiungibile e presidiata.

Nel registro non finiscono i dati

L'attività registrata dice che i contatti sono cambiati, non cosa contengono: sono dati personali e non hanno motivo di essere duplicati in un registro.

Possibili errori

CodiceCausa
400Dati non validi o incompleti per l'estensione del dominio.
401Chiave assente, non valida, scaduta o revocata.
403Manca il permesso Domini — modifica, o il dominio è protetto.
404Il dominio non esiste o la chiave non vi ha accesso.
429Superato il limite di richieste.