Saltar al contenido principal
POST
Follow an asset

Descripción general

Sigue un Asset (activo digital: URL, dirección, perfil, app, etc.) para recibir correos sobre él. Una vez que sigues un asset, ChainPatrol te envía un correo cuando:
  • su estado cambia a BLOCKED (bloqueado) o ALLOWED (permitido), y
  • se completa su Takedown (solicitud de baja de contenido fraudulento).
Es lo mismo que hacer clic en Follow (seguir) en un takedown dentro de la app de ChainPatrol. Los seguimientos hechos aquí y en la app son los mismos, así que puedes deshacerlos desde cualquiera de los dos lugares. Un seguimiento pertenece a una persona, porque esa persona es quien recibe el correo. Requiere una clave de API de usuario (user-scoped) o una sesión iniciada. Las claves de API de organización no tienen una persona a quien enviarle el correo y se rechazan con 403.
Para crear una clave de usuario, abre API Keys (claves de API) en la configuración de tu organización dentro de la app de ChainPatrol y elige el tipo de clave User (“for personal access”, es decir, para acceso personal). Los correos se envían a la dirección de la persona a la que pertenece la clave.

Inicio rápido

Autenticación

Incluye tu clave de API de usuario 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.

Cuerpo de la solicitud

Respuesta

Seguir un asset que ya sigues no es un error: devuelve el estado actual y no consume nada de tu límite.

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

Follow an asset

The person behind the credentials is emailed when the asset's status changes (blocked or allowed) and when its takedown completes. Requires a user-scoped API key or a signed-in session — organization API keys have no person to notify and are refused.

Following an asset you already follow is not an error. One person can follow up to 100 assets per organization.

slug
string

Organization slug. Optional when your API key is scoped to one organization. Required when your credentials can reach more than one.

content
string

Asset content: a URL, domain, wallet address, social profile, etc.

Minimum string length: 1
assetId
integer

ChainPatrol asset ID

Rango requerido: x > 0

Respuesta

Successful response

assetId
integer
requerido

The asset that was followed or unfollowed

following
boolean
requerido

Whether this person now follows the asset

followCount
integer
requerido

How many assets this person follows in this organization

limit
integer
requerido

The most assets one person may follow

warnThreshold
integer
requerido

The count from which warning is set

canFollowMore
boolean
requerido

False once followCount reaches limit; following more is refused

warning
string | null
requerido

Set from warnThreshold upward, asking the caller to unfollow assets