Saltar al contenido principal
POST
Asset connections

Descripción general

Conexiones de assets responde dos preguntas sobre un Asset (activo digital: URL, dirección, perfil, app, etc.): qué llevó a él y a dónde lleva. ChainPatrol registra un vínculo cada vez que un asset nombra a otro en un escaneo: la página de destino de un anuncio, la URL de una publicación, una redirección, los enlaces salientes de una página, el sitio web que un perfil declara como suyo, una wallet a la que una página les pide a las víctimas que paguen. Este endpoint sigue esos vínculos desde el asset que indicas, unos pocos saltos hacia cada lado, y devuelve dos grafos:
  • upstream - lo que lleva al asset: los anuncios y publicaciones que enlazan a él, las páginas y cuentas que los publicaron, los perfiles que lo declaran como propio.
  • downstream - a dónde lleva el asset: a qué redirige, a qué enlaza, qué carga, a dónde envía formularios, qué declara como propio o dónde pide que le paguen.
Cada grafo es una lista de assets y una lista de links (vínculos) entre ellos. Un vínculo se lee como una oración, fromAssetId → type → toAssetId: PUBLISHED, LINKS_TO, REDIRECTS_TO, CLAIMS, REPLIES_TO, REPOSTS, MENTIONS, DEPENDS_ON, MEMBER_OF, LOADS, SUBMITS_TO o USES_WALLET. Los assets incluyen los mismos id, type, content y status que devuelve Buscar assets.
Conexiones de assets se está habilitando de forma gradual, una organización a la vez. Una clave de API de organización que no forma parte del despliegue recibe 403 con el mensaje “Asset connections are not available for this organization”. Contacta a ChainPatrol para solicitar acceso.

Inicio rápido

Autenticación

Incluye la clave de API de tu organización en el encabezado X-API-KEY:

Solicitud de ejemplo

Indica el asset por su contenido (una URL, un dominio, una dirección, un perfil de red social, …) o por su assetId de ChainPatrol: exactamente uno de los dos. depth y limit son opcionales.

Cuerpo de la solicitud

Respuesta

Un sitio de phishing promocionado con un anuncio de Meta, que redirige a un drenador de wallets (wallet drainer) que enlaza al sitio real de la marca:

Nivel superior

Cada asset de un grafo

Cada vínculo de un grafo

Los vínculos son relaciones observadas que se leen de los escaneos de ChainPatrol. Un asset escaneado antes de que se registraran los vínculos, o que nunca fue escaneado, no tiene ninguno. Los vínculos leídos de un escaneo del asset propio de otra organización (su dominio, cuenta o app incluidos en la Allowlist, la lista de permitidos) se omiten, de la misma forma en que Buscar assets y Obtener resultado del escaneo omiten los escaneos de esa organización.

Seguir recorriendo

Una respuesta está acotada: depth saltos, limit vínculos de cada tipo por asset y, como máximo, 25 assets expandidos por salto. Dos campos indican dónde hay más. Un asset con expanded: false y sin stop quedó fuera de esos límites; un asset con hasMoreLinks: true tenía más vínculos de los tipos indicados en truncatedLinkTypes de los que permitió limit. En ambos casos, vuelve a llamar al endpoint con el id de ese asset como assetId para continuar desde él.

Errores

Relacionado

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

Asset connections request body

What led to an asset and where it leads: the links into it (who published, linked to, redirected to or claimed it) and out of it, followed depth hops on each side. Links are observed relationships read from scans, so an asset scanned before links were recorded has none.

assetId
integer

ID of the asset to start from, as returned by /asset/search.

Rango requerido: x > 0
content
string

Content of the asset to start from (a URL, domain, social handle, app listing or wallet address), parsed the way /asset/search parses it. Pass either assetId or content.

Minimum string length: 1
depth
integer
predeterminado:2

How many hops to follow on each side (1 to 3, default 2). One hop is the assets directly linked to the asset; two also follows their links.

Rango requerido: 1 <= x <= 3
limit
integer
predeterminado:10

How many links of each type to read per asset on each side (1 to 100, default 10). Per type, so one redirect still shows behind fifty outbound links. truncatedLinkTypes on an asset says which types had more.

Rango requerido: 1 <= x <= 100

Respuesta

Successful response

Asset connections response body

asset
object
requerido

The asset the connections were read from

upstream
object
requerido

What leads to the asset: the assets that published, linked to, redirected to or claimed it, and what led to those.

downstream
object
requerido

Where the asset leads: what it links to, redirects to or claims, and where those lead.