Saltar al contenido principal
El método asset.list te permite obtener listas masivas de los assets (activos digitales: URL, direcciones, perfiles, apps, etc.) que ChainPatrol ya revisó, con potentes opciones de filtrado por tipo, estado y rango de fechas. Este método es ideal para el análisis masivo y la generación de reportes.

Referencia de la API

Firma del método

Parámetros

AssetListInput
requerido
El objeto de solicitud de la lista de assets, con los criterios de filtrado.

Valor devuelto

array
requerido
Arreglo de objetos de asset que coinciden con los criterios de filtrado.

Opciones de filtrado

Por tipo de asset

Filtra por URL, PAGE o ADDRESS para enfocarte en categorías específicas de assets.

Por estado

Filtra por el estado BLOCKED, ALLOWED o UNKNOWN.

Por rango de fechas

Especifica las fechas de inicio y de fin para analizar períodos específicos.

Por organización

Usa organizationSlug para obtener resultados específicos de una organización.

Primeros pasos

Inicio rápido

Patrones de uso básicos

Guía de implementación

Casos de uso y patrones

Genera reportes periódicos sobre los assets bloqueados para el análisis de seguridad.
Exporta los datos de los assets para cumplir con requisitos normativos y de auditoría.
Analiza las tendencias de amenazas a lo largo del tiempo comparando distintos rangos de fechas.

Análisis masivo

Exportación y procesamiento de datos

Detalles técnicos

Requisitos de formato

Requisitos del formato de fecha - Las fechas deben estar en formato YYYY-MM-DD - endDate debe ser mayor o igual que startDate - El rango máximo de fechas puede estar limitado según tu plan

Manejo de errores

Límites de solicitudes y rendimiento

Límites de solicitudes - Solicitudes paginadas: hasta 5 solicitudes por segundo - Los resultados se paginan cuando los conjuntos de datos son grandes - Considera guardar en caché los resultados de los datos que consultas con frecuencia
Consejos de rendimiento - Usa rangos de fechas específicos para limitar el tamaño de la respuesta - Guarda los resultados en caché cuando sea posible para reducir las llamadas a la API - Considera la paginación para conjuntos de datos muy grandes

Recursos relacionados

Métodos relacionados

asset.check

Consulta el estado de amenaza de un asset individual

asset.submit

Envía assets para la clasificación de amenazas

Documentación adicional