Emettere o rinnovare il certificato

Richiede un nuovo certificato Let's Encrypt per il sito, o rinnova quello esistente.

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

Parametri

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

Nessun corpo. Il sito deve essere già pubblicato e il dominio deve puntare al nostro hosting, altrimenti la verifica di Let's Encrypt fallisce e l'operazione termina in failed.

Esempio di richiesta

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

Esempio di risposta

{
  "job": {
    "id": "wj_8f3k2m",
    "hostname": "esempio.it",
    "type": "web.cron",
    "status": "pending",
    "error": null,
    "createdAt": "2026-10-01T10:00:00.000Z",
    "updatedAt": "2026-10-01T10:00:00.000Z"
  }
}

La risposta contiene un job: la modifica viene applicata entro pochi minuti. Per sapere quando è conclusa, interroga lo stato dell'operazione.

Possibili errori

Codice	Causa
400	Dati non validi.
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Hosting — configurazione siti.
404	Il sito non esiste o la chiave non vi ha accesso.
409	Un'altra operazione è ancora in corso sul sito: riprova tra qualche minuto.
429	Superato il limite di richieste.