Saltar al contenido principal
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:
Los adjuntos pertenecen al reporte en su conjunto y no a un asset individual.

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 arreglo data.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 adecuada

Solució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 altos

Notas

La forma del payload de error es estable en todos los errores 422; revisa data.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

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
assets
object[]
requerido
organizationSlug
string

Organization slug used to identify the organization on ChainPatrol

discordGuildId
string

Discord Guild (Server) ID linked to the organization on ChainPatrol

telegramGroupId
string

Telegram Group ID linked to the organization on ChainPatrol

title
string

Title of the report

Minimum string length: 3
description
string

Description of the report. Supports markdown

contactInfo
string

Optional reporter contact info. If this value is a phone number, include a country code in E.164 format (e.g. +14155552671).

attachmentUrls
string<uri>[]

URLs of files to attach to the report as evidence. Any file type, not only images: .eml/.msg messages, PDFs, and documents are all supported. Upload a file to POST /attachment/upload to get a URL, or pass a publicly reachable URL you host yourself.

Link to the external submission (e.g. Telegram message link)

userAgent
string

User agent string from the reporter's browser

referrer
string

Referrer URL from the reporter's browser

rawAssetsInput
string
externalReporter
object

Respuesta

Successful response

id
number
requerido

ID of the created report

createdAt
string
requerido

Date the report was created

organization
object | null
requerido

Organization the report was created for