Modificare le impostazioni

Aggiorna gli interruttori di un dominio: rinnovo automatico, blocco trasferimento, privacy whois, protezione e gruppo.

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

Parametri

Ogni campo è facoltativo: quelli che ometti restano invariati.

Parametro	Descrizione
autoRenew	Rinnovo automatico alla scadenza.
transferLock	Blocco del trasferimento verso un altro fornitore.
whoisPrivacy	Nasconde i dati dell'intestatario nelle interrogazioni pubbliche.
protected	Protezione da modifiche accidentali: con questa attiva le altre operazioni vengono rifiutate.
groupId	Gruppo a cui assegnare il dominio. null lo toglie dal gruppo.

Esempio di richiesta

Preparare un dominio alla consegna: rinnovo automatico attivo, trasferimento bloccato, dati nascosti.

curl -X PATCH \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"autoRenew":true,"transferLock":true,"whoisPrivacy":true}' \
  https://console.icbs.it/api/v1/domains/esempio.it

Esempio di risposta

{ "domain": "esempio.it", "updated": ["autoRenew", "transferLock", "whoisPrivacy"] }

updated elenca cosa è stato effettivamente applicato: se un campo non compare, non era nella richiesta.

Attenzione all'ordine con protected

La protezione blocca le altre modifiche. Se la attivi nella stessa chiamata in cui cambi altro, imposta prima il resto: una volta attiva, le operazioni successive vengono rifiutate finché non la togli.

Possibili errori

Codice	Causa
400	Nessuna modifica indicata, oppure valori non validi.
401	Chiave assente, non valida, scaduta o revocata.
403	Manca il permesso Domini — modifica, o il dominio è protetto.