Saltar al contenido principal
POST
Get organization time to detection by asset type

Descripción general

Obtén cuánto tiempo llevaban online las amenazas antes de que la automatización de ChainPatrol las detectara por primera vez, por tipo de asset (activo digital: URL, dirección, perfil, app, etc.). Abarca los assets distintos que tu organización bloqueó en un rango de fechas y que siguen bloqueados hoy.
Este endpoint está restringido por el feature flag time-to-detection-chart, que se habilita por organización. Si el flag no está habilitado para tu organización, la API devuelve un error 403 Forbidden. Contacta a ChainPatrol para habilitar el acceso.

Cuerpo de la solicitud

Cómo se mide

El reloj corre desde la primera vez que alguien vio el asset online hasta su primera detección automatizada, para cualquier organización. Un reporte hecho por una persona no detiene el reloj, ni siquiera si es tuyo. byAssetType tiene una entrada por tipo de asset, ordenadas de mayor a menor cantidad de bloqueos: La mediana siempre es un mínimo: la fecha en la que estaba online es la primera vez que alguien vio el asset, y puede que haya estado online antes de eso. Para URLs y páginas solo cuenta una fecha en la que se vio el sitio sirviendo contenido, así que la fecha de registro de un dominio nunca entra en el cálculo.

Autorizaciones

X-API-KEY
string
header
requerido

Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.

Cuerpo

application/json
slug
string
requerido

Organization slug

Minimum string length: 1
startDate
string

Only include assets blocked on or after this date. A date-only value (YYYY-MM-DD) starts at midnight UTC

endDate
string

Only include assets blocked on or before this date. A date-only value (YYYY-MM-DD) covers the whole day in UTC; pass a full timestamp for a precise cut-off

brandIds
integer[]

Only include assets belonging to these brands

Rango requerido: x > 0
countryCodes
string[]

Only include assets scanned from these ISO 3166-1 alpha-2 countries

Required string length: 2

Respuesta

Successful response

byAssetType
object[]
requerido

Time to Detection, one entry per asset type this organization blocked in the range, descending by number blocked. The clock stops at the earliest automated detection of the asset for any organization, not at this organization's report. Assets that do not enter withEvidence are left out of the median. For URL and page assets only an observed-serving date counts, so a domain registration date never enters the number