API

Alle Daten dieser Seite gibt es als REST-API, als JSON, ohne Konto und ohne Tracking. Die API eignet sich für eigene Werkzeuge, Pipelines und Scanner.

Was die API kann

POST /api/v1/querybatch
Viele Pakete auf einmal prüfen, etwa eine Lockfile in der CI (bis zu 1000 pro Anfrage).
POST /api/v1/query
Ein Paket in einer Version prüfen, per Ökosystem und Name oder per purl.
GET /api/v1/vulns/{id}
Eine Schwachstelle mit jeder Kennung (CVE, GHSA, Distribution), samt dem, was jede Quelle sagt.
GET /api/v1/changes
Änderungsprotokoll, um einen eigenen Bestand aktuell zu halten.
GET /api/v1/advisories
Die Meldungen dieser Seite: Zeitraum, Produkte, Risiko, Priorität.
GET /api/v1/eol/{product}, GET /api/v1/stats
Lebenszyklen und Statistik.

Fair Use

Jede Client-Adresse hat ein Budget von 300 Punkten pro Minute, auf einmal höchstens 120.

AnfrageKosten
jede GET-Anfrage1 Punkt
POST /api/v1/query2 Punkte
POST /api/v1/querybatch1 Punkt plus 1 je 10 Pakete

Jede Antwort trägt die Header RateLimit-Policy und RateLimit mit dem verbleibenden Budget. Ist es aufgebraucht, antwortet die API mit 429 Too Many Requests und nennt in Retry-After, wann es weitergeht. Wer mehr braucht, meldet sich unter security@lauger.de.

Bitte geben Sie sich zu erkennen

Setzen Sie einen eigenen User-Agent mit Werkzeug, Version und einer Kontaktadresse. Fällt ein Client auf, melden wir uns, statt ihn zu sperren.

User-Agent: mein-scanner/1.4 (+https://example.com; security@example.com)

Effizient abrufen

  • Einen eigenen Bestand mit /api/v1/changes?after=<seq> aktuell halten und nur geänderte Einträge nachladen, statt die Liste durchzublättern.
  • Antworten tragen ein ETag; mit If-None-Match kommt bei unveränderten Daten nur 304 zurück.
  • Viele Pakete in einer querybatch-Anfrage statt vieler Einzelabfragen.
curl -s https://security.lauger.de/api/v1/querybatch \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: mein-scanner/1.4 (security@example.com)' \
  -d '{"queries":[{"package":{"purl":"pkg:pypi/jinja2@3.1.2"}},
                  {"package":{"ecosystem":"npm","name":"express"},"version":"4.18.2"}]}'

Datenschutz

Anfragen werden aus der eigenen Datenbank beantwortet, nie an eine Quelle weitergegeben, nicht gespeichert und nicht protokolliert. Die Client-Adresse liegt nur zum Zählen des Budgets höchstens eine Stunde im Arbeitsspeicher.

Lizenzen der Daten

Die Daten stammen aus öffentlichen Quellen mit eigenen Lizenzen. Jeder Datensatz einer Antwort nennt seine Quelle und Lizenz; die Übersicht liefert /api/v1/sources. Mehr zu den Quellen steht unter Methodik.