Documentación de la API de Tráfico No Deseado

La API de Tráfico No Deseado proporciona acceso a datos recopilados de sensores honeypot, capturando actividades maliciosas de red como escaneos y ataques. Esta documentación cubre todos los puntos finales, opciones de filtrado, paginación y manejo de errores.

URL Base

https://defrancisco.us/unwanted-traffic/

Autenticación

Todas las solicitudes requieren una clave API, proporcionada en el encabezado X-API-Key.

curl -H "X-API-Key: YOUR_API_KEY" https://defrancisco.us/unwanted-traffic/test

Contáctanos si necesitas una clave API para realizar investigaciones de ciberseguridad.

Límite de Tasa

La API impone límites de tasa para garantizar un uso justo:

• Por defecto: 100 solicitudes por minuto por dirección IP.
• Puntos finales específicos (por ejemplo, /sessions, /attempts, /malware): 50 solicitudes por minuto por dirección IP.

Exceder estos límites resulta en un error 429 Demasiadas Solicitudes.

Formato de Respuesta

Todas las respuestas están en formato JSON con la siguiente estructura:

• status: Indica éxito ("success") o fallo ("error").
• data: Contiene los datos solicitados (matriz u objeto).
• message: Descripción del error (si aplica).
• pagination: Metadatos de paginación (para puntos finales paginados).

Establezca el encabezado Accept: application/json en las solicitudes.

Primeros Pasos

Pruebe la API con el punto final /test:

curl -H "X-API-Key: YOUR_API_KEY" -H "Accept: application/json" https://defrancisco.us/unwanted-traffic/test

Respuesta:

{
  "status": "success",
  "message": "Unwanted Traffic API is running"
}

Navegación

• Puntos finales: Documentación detallada de todos los puntos finales de la API.
• Filtros: Opciones de filtrado simple y complejo para consultas.
• Paginación: Parámetros de paginación para conjuntos de datos grandes.
• Errores: Códigos de error posibles y sus significados.