Obtener conexiones de assets
Answers ‘what led to this asset, and where does it lead?’. Takes one asset (by assetId or content) and returns the assets linked into it (upstream: the page that ran the ad, the ad that linked to it, the account that claimed it) and out of it (downstream: what it redirects to, links to or claims), followed depth hops on each side, as two graphs of assets and typed links. Nodes carry the same id, type, content and status that /asset/search returns. Available to organizations the threat graph connections rollout has been turned on for; others receive FORBIDDEN.
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.
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.
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 encabezadoX-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 suassetId 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
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
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
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.
Respuesta
Successful response
Asset connections response body