Référence API CertH — Endpoints, paramètres et exemples
Référence API CertH complète : endpoints de scan, historique, classement, monitoring et alertes, avec auth, limites, codes d'erreur et exemples curl.
/api/scan
Analyse instantanée de tout domaine : note, score, facteurs et informations du certificat ; persistée avec limitation.
curl -X POST https://certh.csr.plus/api/scan -H "Content-Type: application/json" -d '{"domain":"stripe.com"}'
/api/public/domains/:domain/history
Historique des notes pour les domaines classés : 45 jours gratuits, la clé API débloque plus (Pro 90 / Agency 365).
curl "https://certh.csr.plus/api/public/domains/notion.so/history?days=90" -H "x-api-key: ch_xxx"
/api/leaderboard
Classements mondiaux de santé TLS avec paramètres page, pageSize, sort, grade et q.
curl "https://certh.csr.plus/api/leaderboard?page=1&pageSize=50&sort=score&grade=A%2B"
/api/domain/:domain
Dernier état scanné d'un domaine (une ligne latest_snapshot).
curl https://certh.csr.plus/api/domain/stripe.com
/api/plans
Liste des plans avec les limites de capacité free / Pro / Agency.
curl https://certh.csr.plus/api/plans
/api/me
Utilisateur courant, plan et clé API.
curl -b cookie.txt https://certh.csr.plus/api/me
/api/domains
Gestion des domaines suivis (ajout, liste, suppression ; l'ajout scanne immédiatement).
curl -X POST https://certh.csr.plus/api/domains -H "Authorization: Bearer <jwt>" -H "Content-Type: application/json" -d '{"domain":"example.com"}'
/api/domains/:domain/history|events
Instantanés d'historique privés et événements de changement (alertes, rotations, etc.) de vos domaines.
curl "https://certh.csr.plus/api/domains/example.com/history?days=90" -H "Authorization: Bearer <jwt>"
/api/ingest
Signaler vos propres résultats de scan (plans avancés) dans le même pipeline de monitoring.
curl -X POST https://certh.csr.plus/api/ingest -H "x-api-key: ch_xxx" -H "Content-Type: application/json" -d '{"domain":"example.com","result":{...}}'
/api/discover
Découvertes de journaux CT (nouveaux sous-domaines / certificats).
curl https://certh.csr.plus/api/discover -H "Authorization: Bearer <jwt>"
/api/alert-rules
Gestion des règles d'alerte pour baisses de note, expiration, rotations, etc.
curl -X POST https://certh.csr.plus/api/alert-rules -H "Authorization: Bearer <jwt>" -H "Content-Type: application/json" -d '{"domain":"example.com","type":"GRADE_CHANGE","target":"you@x.com"}'
Limites et politique de données
- Les requêtes publiques sont persistées : ≤20 nouveaux domaines par IP et par jour ; au plus 1 instantané par domaine et par heure.
- Rétention : les données de classement (système) sont conservées ≥365 jours ; le niveau gratuit tronque à 45 jours.
- Badges : cache périphérique 1 heure (max-age=3600) ; tout paramètre de requête contourne le cache.
- Codes d'erreur : 400 paramètres invalides / 401 non authentifié / 403 interdit ou limite / 404 aucune donnée / 422 échec du scan / 429 limite atteinte.
Questions fréquentes
Quel historique les utilisateurs gratuits obtiennent-ils ?
Les utilisateurs gratuits obtiennent 45 jours d'historique sans inscription ; Pro débloque 90 jours et Agency 365 jours via la clé API.
Où obtenir une clé API ?
Connectez-vous au tableau de bord et une clé préfixée ch_ est générée automatiquement ; envoyez-la via l'en-tête x-api-key ou le paramètre ?api_key.
Les requêtes sont-elles persistées en base ?
Les requêtes publiques sont persistées avec limitation : le premier scan crée l'enregistrement, les scans suivants ajoutent à l'historique (au plus une fois par domaine et par heure).