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.
| Anfrage | Kosten |
|---|---|
| jede GET-Anfrage | 1 Punkt |
POST /api/v1/query | 2 Punkte |
POST /api/v1/querybatch | 1 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; mitIf-None-Matchkommt bei unveränderten Daten nur304zurü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.