Certificato SSL

Restituisce il certificato installato sul sito, con scadenza ed emittente.

• Metodo: GET
• Indirizzo: https://console.icbs.it/api/v1/hosting/{hostname}/ssl
• Permesso: Hosting — lettura

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
hostname	indirizzo	sì	Il nome del sito, per esempio esempio.it.

Esempio di richiesta

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

Esempio di risposta

{
  "certificate": {
    "type": "letsencrypt",
    "domains": ["esempio.it", "www.esempio.it"],
    "issuer": "C=US, O=Let's Encrypt, CN=R11",
    "notBefore": "2026-09-01T08:12:00.000Z",
    "notAfter": "2026-11-30T08:12:00.000Z",
    "serial": "04A1…",
    "fingerprint": "3F:9B:…"
  }
}

Campi della risposta

Campo	Descrizione
type	letsencrypt, self-signed oppure other.
domains	Nomi coperti dal certificato.
notAfter	Scadenza. I certificati Let's Encrypt si rinnovano da soli prima di questa data.

certificate è null se non c'è nessun certificato installato o se il server non è raggiungibile in quel momento.

Possibili errori

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