CertH certH

API pubblica CertH

Integra la valutazione TLS di CertH nei tuoi strumenti, CI o dashboard. Il livello gratuito non richiede registrazione; una chiave API sblocca lo storico completo.

Scansione immediata

POST /api/scan

Valutazione TLS in tempo reale per qualsiasi dominio — punteggio 0-100 e voto da A+ a F, senza autenticazione.

Storico dei punteggi

GET /api/public/domains/:domain/history

45 giorni gratuiti; la chiave API sblocca 90 giorni (Pro) / 365 giorni (Agency).

Dati della classifica

GET /api/leaderboard

Classifiche globali di salute TLS con filtri per voto, settore e regione, più paginazione.

Prova dal vivo

Chiama gli endpoint pubblici direttamente qui — senza registrazione. Le richieste partono da questa pagina e restituiscono dati reali.

Endpoint
Risposta
—

Le richieste sono same-origin; POST /api/scan viene persistito con limitazione (≤20 nuovi domini per IP al giorno, ≤1 snapshot per dominio all'ora).

Autenticazione e livello gratuito

· Scansione immediata e storico 45 giorni: senza autenticazione, pronto all'uso.

· Storico più lungo: accedi alladashboardper ottenere una chiave API gratuita (prefisso ch_) e inviala tramite header x-api-key.

· Limiti: ≤20 nuovi domini persistiti per IP al giorno; al massimo 1 snapshot per dominio all'ora.

Riferimento API completo

Ogni endpoint, parametro, esempio di risposta e codice di errore.

Leggi la documentazione

Domande frequenti

Serve un account per usare l'API?

No — scansione immediata e storico 45 giorni funzionano senza registrazione; una chiave API sblocca uno storico più lungo.

Quali sono i limiti dell'API?

≤20 nuovi domini persistiti per IP al giorno; al massimo uno snapshot per dominio all'ora.

Come ottengo uno storico più lungo?

Passa a Pro (90 giorni) o Agency (365 giorni) e invia la tua chiave API tramite header x-api-key.