Dettaglio di un dominio

Restituisce lo stato completo di un dominio: blocco trasferimento, privacy whois, DNSSEC, nameserver e servizi attivi.

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

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio, per esempio esempio.it.

Esempio di richiesta

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

Esempio di risposta

{
  "name": "esempio.it",
  "status": "active",
  "autoRenew": true,
  "registeredAt": "2024-03-11",
  "expiresAt": "2027-03-11",
  "nameservers": ["ns1.icbs.it", "ns2.icbs.it"],
  "transferLock": { "enabled": true, "supported": true },
  "whoisPrivacy": { "enabled": true, "supported": true },
  "dnssec": {
    "enabled": true,
    "keys": [{ "flags": "257", "alg": "13", "protocol": 3, "pubKey": "mdsswUyr3D..." }]
  },
  "services": {
    "dns": true,
    "email": true,
    "ftp": true,
    "mysql": true,
    "hosting": true,
    "backups": true
  },
  "usage": { "mailusers": 4, "ftpusers": 2, "subdomains": 1, "databases": 2 },
  "limits": { "maxmailusers": 20, "maxftpusers": 10, "maxsubdomains": 5, "maxdatabases": 5 }
}

Campi della risposta

Campo	Descrizione
autoRenew	Se il rinnovo automatico è attivo.
transferLock	enabled: il dominio è bloccato contro il trasferimento. supported: quel dominio permette il blocco.
whoisPrivacy	Se la protezione dei dati di contatto è attiva, e se è disponibile per quel dominio.
dnssec	Se DNSSEC è attivo, con le chiavi pubblicate.
services	Quali servizi sono attivi sul dominio.
usage	Quante caselle, utenti FTP, subdomini e database sono in uso.
limits	I massimi consentiti; null dove non c'è un limite.

I dati dell'intestatario non compaiono

Nome, indirizzo, email e telefono dell'intestatario non sono restituiti da questa chiamata: sono dati personali e non hanno motivo di transitare nei log di uno strumento di automazione. Si consultano in console.

Attenzione alla frequenza

Questa chiamata verifica lo stato aggiornato del dominio, quindi è più lenta dell'elenco. Su un parco di molti domini, interrogarli tutti in sequenza consuma rapidamente il limite orario: usa l'elenco dei domini per la panoramica e questa chiamata solo sui domini che ti interessano davvero.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Domini — lettura.
404	Il dominio non esiste o la chiave non vi ha accesso.
429	Superato il limite di richieste.