Reportes
Crear reporte
Create a new report on ChainPatrol for a particular organization
POST
Create a report
Descripción general
El endpoint Crear reporte te permite enviar Assets (activos digitales: URL, dominios, direcciones de blockchain, etc.) para que el equipo de ChainPatrol los revise. Este endpoint admite envíos masivos y ofrece información detallada de los errores cuando falla la validación. ¿Es tu primera vez con este endpoint? Empieza por Cómo crear reportes: una guía paso a paso de todo el flujo, con ejemplos prácticos.Este endpoint necesita una clave de API con permiso Read & write (lectura y escritura). Una
clave de solo lectura recibe
403 Forbidden. Consulta Permisos de la clave.Adjuntos
attachmentUrls acepta URL de cualquier archivo de evidencia, no solo imágenes: los mensajes
.eml y .msg, los PDF, los documentos y las capturas de pantalla funcionan. Las imágenes se
muestran integradas en el reporte; los demás archivos se listan como evidencia descargable que
nuestro equipo de Takedowns (solicitudes de baja de contenido fraudulento) puede reenviar a
un registrador o proveedor de hosting.
Para enviarnos el archivo en sí en lugar de un enlace que tú alojas, súbelo primero con
Subir archivo adjunto y pasa la URL que devuelve:
Respuestas de error
422 Unprocessable Content
Se devuelve cuando la solicitud es sintácticamente válida pero contiene errores de validación o assets duplicados. Es el tipo de error más común y ofrece información detallada de errores por asset.Ejemplo: assets duplicados
Ejemplo: varios errores de validación
500 Internal Server Error
Se devuelve ante condiciones inesperadas del servidor, incluidos errores de base de datos y otras fallas técnicas. La respuesta usa mensajes seguros y genéricos para no exponer detalles internos del sistema.Respuesta de error estándar
Respuesta de error de base de datos
Buenas prácticas
Validación de assets
URL: Incluye el protocolo completo (https:// o http://)
Dominios: Usa nombres de dominio limpios, sin protocolos ni rutas
Direcciones de blockchain: Usa el formato EIP-155 para las direcciones de Ethereum
Evita duplicados: Cada asset debe aparecer una sola vez por reporte
Manejo de errores
Revisa siempre el arreglodata.errors en las respuestas 422 para ver los detalles por asset
Usa el campo suggestion de las respuestas de error para orientar a los usuarios
Implementa una lógica de reintentos con backoff exponencial para los errores 500
Consejos de rendimiento
Agrupa varios assets en una sola solicitud cuando sea posible Valida los formatos de los assets del lado del cliente antes de enviarlos Maneja el límite de solicitudes de forma adecuadaSolución de problemas
Problemas comunes
Errores “INVALID_FORMAT”: Asegúrate de que las URL incluyan el protocolo (https:// o http://)
Verifica que los nombres de dominio no incluyan protocolos ni rutas
Comprueba que el formato de la dirección de blockchain coincida con el estándar EIP-155
Errores “DUPLICATE_ASSETS”:
Quita las entradas duplicadas del arreglo de assets
Revisa si hay diferencias de mayúsculas y minúsculas
Verifica la normalización de las URL (barras finales, etc.)
Errores “DOMAIN_NOT_ALLOWED”:
El dominio está en la lista de ignorados de ChainPatrol
Escribe a disputes@chainpatrol.io para disputar esta decisión
Considera reportar URL específicas en lugar del dominio completo
Errores “ASSET_ALREADY_CORRECT”:
El asset ya tiene el estado que estás solicitando
Revisa el estado actual del asset antes de reportarlo
No hace falta ninguna acción: el asset ya está en el estado deseado
Límite de solicitudes
El endpoint aplica un límite de solicitudes para prevenir abusos. Si recibes errores de límite de solicitudes: Implementa backoff exponencial en tu lógica de reintentos Considera agrupar solicitudes para reducir las llamadas a la API Contacta a soporte si necesitas límites de solicitudes más altosNotas
La forma del payload de error es estable en todos los errores 422; revisadata.errors para ver los detalles por asset
Proporciona el organizationSlug y assets válidos para minimizar los errores 500 causados por un estado inválido
Todos los assets deben ser válidos para que se cree el reporte
Solo se puede crear un reporte una vez por dirección de correo electrónico para un asset específico
Si tienes problemas técnicos o preguntas sobre las respuestas de error, escribe a support@chainpatrol.io e incluye la respuesta de error completa en tu solicitud.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
application/json