Documentation API
Lancez des analyses et récupérez résultats et rapports via l’API REST.
Authentification
Utilisez Authorization: Bearer <API_KEY> et gardez la clé hors du code public.
Créez une clé dans Tableau de bord → Paramètres → Clés API.
curl -H "Authorization: Bearer YOUR_API_KEY" https://issafesite.com/api/v1/scanURL de base
https://issafesite.com/api/v1Limites
Gratuit : 3 analyses par jour et 10 requêtes par minute. Pro : 50 par jour et 60 par minute. Team : analyses illimitées et 300 requêtes par minute.
| Détails des offres | Analyses par jour | Requêtes par minute |
|---|---|---|
| Free | 3 | 10 |
| Pro | 50 | 60 |
| Team | ∞ | 300 |
Points d’accès
POST /api/v1/scan crée une analyse, GET /api/v1/scan liste les analyses et GET /api/v1/report récupère les rapports.
POST /api/v1/scan
Le corps POST exige url ; depth accepte QUICK, STANDARD (par défaut) ou DEEP. Les listes acceptent page (1) et limit (20, maximum 50) ; scanId filtre les rapports.
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 · Créé
GET /api/v1/scan
Paramètres: Page=1, Limite=20 (≤50)
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/scan?page=1&limit=10"GET /api/v1/report
Paramètres: scanId, Page, Limite
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/report?scanId=clx1abc"Erreurs
La création renvoie 202 et les listes 200. Les erreurs JSON contiennent error ; 401 signale une clé absente et 403 une clé invalide ou expirée.
{ "error": "..." }| 400 | Paramètres absents ou invalides |
| 401 | Clé API manquante |
| 403 | Clé invalide ou expirée |
| 429 | Limite de requêtes ou quota dépassé |
| 500 | Erreur interne du serveur |
Démarrage rapide
Lancez des analyses et récupérez résultats et rapports via l’API REST.
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"}'Assistance
Respectez les limites de votre offre. En cas d’erreur, consultez le statut HTTP et la réponse JSON.
support@issafesite.com