Documentación de la API
Inicia análisis y consulta resultados e informes con la API REST.
Autenticación
Envía Authorization: Bearer <API_KEY> y mantén la clave fuera del código público.
Crea una clave en Panel → Configuración → Claves API.
curl -H "Authorization: Bearer YOUR_API_KEY" https://issafesite.com/api/v1/scanURL base
https://issafesite.com/api/v1Límites
Gratis: 3 análisis al día y 10 solicitudes por minuto. Pro: 50 al día y 60 por minuto. Team: análisis ilimitados y 300 solicitudes por minuto.
| Detalles de los planes | Análisis diarios | Solicitudes por minuto |
|---|---|---|
| Free | 3 | 10 |
| Pro | 50 | 60 |
| Team | ∞ | 300 |
Endpoints
POST /api/v1/scan crea un análisis; GET /api/v1/scan enumera los análisis; GET /api/v1/report recupera informes.
POST /api/v1/scan
El cuerpo POST requiere url; depth admite QUICK, STANDARD (predeterminado) o DEEP. Las listas aceptan page (1) y limit (20, máximo 50); los informes pueden filtrarse con scanId.
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 · Creado
GET /api/v1/scan
Parámetros: Página=1, Límite=20 (≤50)
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/scan?page=1&limit=10"GET /api/v1/report
Parámetros: scanId, Página, Límite
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/report?scanId=clx1abc"Errores
La creación devuelve 202 y las listas 200. Los errores JSON incluyen error; 401 indica clave ausente y 403 clave inválida o caducada.
{ "error": "..." }| 400 | Parámetros ausentes o inválidos |
| 401 | Falta la clave API |
| 403 | Clave inválida o caducada |
| 429 | Límite de solicitudes o cuota superados |
| 500 | Error interno del servidor |
Inicio rápido
Inicia análisis y consulta resultados e informes con la 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"}'Soporte
Respeta los límites de tu plan y consulta el código HTTP y la respuesta JSON ante errores de autenticación, entrada o frecuencia.
support@issafesite.com