Elenco dei record

Restituisce tutti i record della zona DNS di un dominio.

È la chiamata da cui ricavare l'id dei record, necessario per modificarli o eliminarli.

• Metodo: GET
• Indirizzo: https://console.icbs.it/api/v1/domains/{dominio}/dns/records
• Permesso: DNS — 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/dns/records

Esempio di risposta

{
  "domain": "esempio.it",
  "data": [
    {
      "id": "123456",
      "type": "A",
      "host": "",
      "record": "93.184.216.34",
      "ttl": "3600"
    },
    {
      "id": "123457",
      "type": "A",
      "host": "www",
      "record": "93.184.216.34",
      "ttl": "3600"
    },
    {
      "id": "123458",
      "type": "MX",
      "host": "",
      "record": "mail.esempio.it",
      "priority": "10",
      "ttl": "3600"
    },
    {
      "id": "123459",
      "type": "TXT",
      "host": "",
      "record": "v=spf1 include:_spf.icbs.it ~all",
      "ttl": "3600",
      "managedBy": "email",
      "managedMessage": "Record gestito dal servizio Email attivo sul dominio"
    }
  ]
}

Campi della risposta

Campo	Descrizione
domain	Il dominio richiesto.
id	Identificativo del record, da usare per modifica ed eliminazione.
type	Tipo di record: A, AAAA, CNAME, MX, TXT, SRV, CAA e gli altri tipi supportati.
host	Il sottodominio. Stringa vuota o @ per il dominio principale.
record	Il valore del record.
ttl	Tempo di vita in secondi.
priority	Presente sui tipi che la usano, come MX e SRV.

Record gestiti automaticamente

Alcuni record sono creati e mantenuti dai servizi attivi sul dominio — per esempio i record di posta quando è attivo il servizio Email, o quelli di verifica di un certificato.

Questi record hanno due campi in più:

Campo	Descrizione
managedBy	Il servizio che li gestisce.
managedMessage	La spiegazione del perché non sono modificabili.

Tentare di modificarli o eliminarli restituisce 400.

Se stai scrivendo un'automazione che ripulisce record, salta quelli che hanno managedBy: sono la causa più comune di errori inattesi in uno script di manutenzione.

Possibili errori

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