CertH certH

CertH API-Referenz — Endpunkte, Parameter & Beispiele

Vollständige CertH-API-Referenz: Scan-, Verlaufs-, Ranglisten-, Monitoring- und Alarm-Endpunkte mit Auth, Limits, Fehlercodes und curl-Beispielen.

POST /api/scan
Domains, Trends & Alarme überwachen: Keine

Sofort-Scan für jede Domain: Note, Punkte, Faktoren und Zertifikatsinfos; mit Drosselung gespeichert.

curl -X POST https://certh.csr.plus/api/scan -H "Content-Type: application/json" -d '{"domain":"stripe.com"}'
GET /api/public/domains/:domain/history
Domains, Trends & Alarme überwachen: Optionaler API-Key

Bewertungsverlauf für Ranglisten-Domains: 45 Tage kostenlos, API-Key schaltet mehr frei (Pro 90 / Agency 365).

curl "https://certh.csr.plus/api/public/domains/notion.so/history?days=90" -H "x-api-key: ch_xxx"
GET /api/leaderboard
Domains, Trends & Alarme überwachen: Keine

Globale TLS-Gesundheits-Rangliste mit page-, pageSize-, sort-, grade- und q-Parametern.

curl "https://certh.csr.plus/api/leaderboard?page=1&pageSize=50&sort=score&grade=A%2B"
GET /api/domain/:domain
Domains, Trends & Alarme überwachen: Keine

Neuester Scan-Status einer Domain (einzelne latest_snapshot-Zeile).

curl https://certh.csr.plus/api/domain/stripe.com
GET /api/plans
Domains, Trends & Alarme überwachen: Keine

Tarifliste mit den Leistungsgrenzen von free / Pro / Agency.

curl https://certh.csr.plus/api/plans
GET /api/me
Domains, Trends & Alarme überwachen: Session Cookie (OAuth) 或 ?api_key=

Aktueller Benutzer, Tarif und API-Key.

curl -b cookie.txt https://certh.csr.plus/api/me
GET/POST/DELETE /api/domains
Domains, Trends & Alarme überwachen: JWT

Verwaltung überwachter Domains (hinzufügen, auflisten, entfernen; Hinzufügen scannt sofort).

curl -X POST https://certh.csr.plus/api/domains -H "Authorization: Bearer <jwt>" -H "Content-Type: application/json" -d '{"domain":"example.com"}'
GET /api/domains/:domain/history|events
Domains, Trends & Alarme überwachen: JWT

Private Verlaufssnapshots und Änderungsereignisse (Alarme, Rotationen usw.) Ihrer Domains.

curl "https://certh.csr.plus/api/domains/example.com/history?days=90" -H "Authorization: Bearer <jwt>"
POST /api/ingest
Domains, Trends & Alarme überwachen: API Key

Eigene Scan-Ergebnisse melden (erweiterte Tarife) und in dieselbe Monitoring-Pipeline speisen.

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":{...}}'
GET /api/discover
Domains, Trends & Alarme überwachen: JWT

CT-Log-Entdeckungen (neue Subdomains / Zertifikate).

curl https://certh.csr.plus/api/discover -H "Authorization: Bearer <jwt>"
GET/POST/DELETE /api/alert-rules
Domains, Trends & Alarme überwachen: JWT

Verwaltung von Alarmregeln für Notenabfälle, Ablauf, Rotationen und mehr.

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"}'

Limits & Datenstrategie

  • Öffentliche Abfragen werden gespeichert: ≤20 neue Domains pro IP und Tag; höchstens 1 Snapshot pro Domain und Stunde.
  • Aufbewahrung: Ranglisten- (System-) Daten ≥365 Tage; der kostenlose API-Tarif begrenzt auf 45 Tage.
  • Badges: Edge-Cache 1 Stunde (max-age=3600); beliebiger Query-Parameter umgeht den Cache.
  • Fehlercodes: 400 ungültige Parameter / 401 nicht authentifiziert / 403 verboten oder Limit / 404 keine Daten / 422 Scan fehlgeschlagen / 429 zu viele Anfragen.

Häufige Fragen

Wie viel Verlauf erhalten kostenlose Nutzer?

Kostenlose Nutzer erhalten 45 Tage Bewertungsverlauf ohne Registrierung; Pro schaltet 90 Tage und Agency 365 Tage per API-Key frei.

Wo erhalte ich einen API-Key?

Nach der Anmeldung im Dashboard wird automatisch ein Schlüssel mit Präfix ch_ generiert; per x-api-key-Header oder ?api_key-Parameter senden.

Werden Abfragen in der Datenbank gespeichert?

Öffentliche Abfragen werden mit Drosselung gespeichert: der erste Scan legt den Datensatz an, wiederholte Scans ergänzen den Verlauf (max. 1× pro Stunde).