API-Dokumentation
Starten Sie Scans und rufen Sie Ergebnisse und Berichte über die REST-API ab.
Authentifizierung
Verwenden Sie Authorization: Bearer <API_KEY> und veröffentlichen Sie den Schlüssel nicht.
Endpunkte
POST /api/v1/scan erstellt einen Scan, GET /api/v1/scan listet Scans auf und GET /api/v1/report ruft Berichte ab.
Limits und Fehler
Beachten Sie die Grenzen Ihres Tarifs. Prüfen Sie bei Fehlern HTTP-Status und JSON-Antwort.
Erstellen Sie einen Schlüssel unter Dashboard → Einstellungen → API-Schlüssel.
https://issafesite.com/api/v1
Free: 3 Scans täglich und 10 Anfragen pro Minute. Pro: 50 täglich und 60 pro Minute. Team: unbegrenzte Scans und 300 Anfragen pro Minute.
Der POST-Body benötigt url; depth kann QUICK, STANDARD (Standardwert) oder DEEP sein. Listen akzeptieren page (1) und limit (20, maximal 50); Berichte lassen sich mit scanId filtern.
curl -X POST https://issafesite.com/api/v1/scan \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","depth":"STANDARD"}'Die Erstellung liefert 202, Listen 200. JSON-Fehler enthalten error; 401 bedeutet fehlender Schlüssel, 403 ungültiger oder abgelaufener Schlüssel.