Saltar al contenido principal
POST
Get currently blocked threats by first-report source

Descripción general

Cuenta los assets (activos digitales: URL, dirección, perfil, app, etc.) distintos que están actualmente bloqueados y cuyo primer reporte para tu organización cae dentro de un rango de fechas, separados según quién los reportó primero: tu equipo (customer) o ChainPatrol (chainpatrol). Usa este endpoint para ver cuántas amenazas bloqueadas fueron descubiertas de forma proactiva por ChainPatrol y cuántas fueron enviadas por tu propio equipo y tu comunidad.
Este endpoint está restringido por el feature flag threat-discovery-source-api, 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.

Cómo se cuentan los assets

  • Cohorte del primer reporte — Cada asset se atribuye al origen de su primer reporte no eliminado para tu organización. El rango de fechas filtra según cuándo se creó ese primer reporte, no según cuándo se bloqueó el asset.
  • Solo bloqueados — Solo se cuentan los assets cuyo estado actual (o estado pendiente) es BLOCKED. Los assets que se reportaron dentro del rango pero nunca se bloquearon, o que luego se desbloquearon, quedan excluidos.
  • Categorías de origen:
    • customer — assets reportados primero por tu equipo, por un reportante externo o por un usuario con rol de cliente.
    • chainpatrol — assets reportados primero por el personal de ChainPatrol o por la automatización. El personal y la automatización se agrupan en una sola categoría.
    • totals — customer + chainpatrol.
totals.blocked no coincide con los conteos de POST /metrics/found. Este endpoint aplica el rango sobre la fecha del primer reporte de cada asset, mientras que /metrics/found cuenta los assets según cuándo se bloquearon.

Manejo de fechas

  • startDate y endDate son obligatorios, y startDate debe ser igual o anterior a endDate.
  • Los valores de solo fecha (YYYY-MM-DD) se interpretan en UTC. startDate empieza a la medianoche UTC y endDate abarca todo el día (hasta las 23:59:59.999 UTC). Envía una marca de tiempo ISO 8601 completa si necesitas un corte preciso.
  • Las fechas de calendario imposibles (por ejemplo, 2026-02-31) se rechazan con un error 400 en lugar de trasladarse al mes siguiente.

Filtrado por marca

Envía el arreglo opcional brandIds para limitar los conteos a los assets que pertenecen a marcas específicas. Todos los ID deben pertenecer a tu organización. Si algún ID hace referencia a una marca ajena a tu organización (o a una marca eliminada), la API devuelve un error 404 en lugar de ignorarlo silenciosamente.

Ejemplo de solicitud

Ejemplo de respuesta

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
requerido

Only include assets whose earliest report was created on or after this date. A date-only value (YYYY-MM-DD) starts at midnight UTC

endDate
string
requerido

Only include assets whose earliest report was created 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

Respuesta

Successful response

range
object
requerido
customer
object
requerido

Currently blocked assets first reported by the customer (reportedByCustomer, external reporter, or customer-role user)

chainpatrol
object
requerido

Currently blocked assets first reported by ChainPatrol staff or automation. Staff and automation are collapsed together.

totals
object
requerido

customer + chainpatrol. This is a first-report blocked cohort and does not equal metrics/found, which counts assets by blockedAt.