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.
Erstellen Sie einen Schlüssel unter Dashboard → Einstellungen → API-Schlüssel.
curl -H "Authorization: Bearer YOUR_API_KEY" https://issafesite.com/api/v1/scanBasis-URL
https://issafesite.com/api/v1Limits
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.
| Tarifdetails | Scans pro Tag | Anfragen pro Minute |
|---|---|---|
| Free | 3 | 10 |
| Pro | 50 | 60 |
| Team | ∞ | 300 |
Endpunkte
POST /api/v1/scan erstellt einen Scan, GET /api/v1/scan listet Scans auf und GET /api/v1/report ruft Berichte ab.
POST /api/v1/scan
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"}'202 · Erstellt
GET /api/v1/scan
Parameter: Seite=1, Limit=20 (≤50)
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/scan?page=1&limit=10"GET /api/v1/report
Parameter: scanId, Seite, Limit
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/report?scanId=clx1abc"Fehlerantworten
Die Erstellung liefert 202, Listen 200. JSON-Fehler enthalten error; 401 bedeutet fehlender Schlüssel, 403 ungültiger oder abgelaufener Schlüssel.
{ "error": "..." }| 400 | Fehlende oder ungültige Parameter |
| 401 | API-Schlüssel fehlt |
| 403 | Schlüssel ungültig oder abgelaufen |
| 429 | Anfrage- oder Tariflimit überschritten |
| 500 | Interner Serverfehler |
Schnellstart
Starten Sie Scans und rufen Sie Ergebnisse und Berichte über die REST-API ab.
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"}'Support
Beachten Sie die Grenzen Ihres Tarifs. Prüfen Sie bei Fehlern HTTP-Status und JSON-Antwort.
support@issafesite.com