Restituisce i domini accessibili alla chiave, con stato, date e nameserver.
Se la chiave è limitata ad alcuni domini, l'elenco contiene solo quelli: è il modo più rapido per verificare su cosa può davvero agire.
GEThttps://console.icbs.it/api/v1/domainsNessuno.
curl -H "Authorization: Bearer $ICBS_API_KEY" \
https://console.icbs.it/api/v1/domains
{
"data": [
{
"id": 318,
"name": "esempio.it",
"status": "active",
"registeredAt": "2024-03-11",
"expiresAt": "2027-03-11",
"nameservers": ["ns1.icbs.it", "ns2.icbs.it"],
"group": "Clienti"
},
{
"id": 942,
"name": "altro-esempio.com",
"status": "active",
"registeredAt": "2025-09-02",
"expiresAt": "2026-09-02",
"nameservers": ["ns1.icbs.it", "ns2.icbs.it"],
"group": null
}
]
}
| Campo | Descrizione |
|---|---|
id | Identificativo del dominio. È il valore che compare in domains.ids di Verificare la chiave. |
name | Il nome a dominio. È questo, non l'id, che va usato nelle chiamate sui record DNS. |
status | active o inactive. Un dominio inattivo resta leggibile ma non modificabile. |
registeredAt | Data di registrazione, null se non disponibile. |
expiresAt | Data di scadenza, null se non disponibile. |
nameservers | I nameserver impostati sul dominio, null se non configurati. |
group | Il gruppo assegnato al dominio, se non ne ha uno. |
null| Codice | Causa |
|---|---|
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso Domini — lettura. |
429 | Superato il limite di richieste. |
Un elenco vuoto non è un errore: significa che l'account non ha domini, oppure che la chiave è limitata a domini che nel frattempo non sono più accessibili.