Saltar al contenido principal
Usamos claves de API para autenticar las solicitudes. Los propietarios y administradores de la organización pueden crear una desde Developer › API Keys (claves de API) en el Dashboard (panel principal) de ChainPatrol. Consulta Obtén tu clave de API para ver una guía paso a paso.

Cómo autenticar una solicitud

Para autenticar una solicitud, debes incluir en ella un encabezado X-API-KEY con el valor de tu clave de API:

Permisos de la clave

Cada clave de API tiene uno de dos permisos, que se elige al crearla: Para enviar reportes se necesita una clave Read & write. Lo mismo aplica a cualquier otro endpoint que cree o modifique datos, como Crear reporte, Enviar asset, Crear disputa, y agregar, actualizar o quitar assets de la organización (activos digitales: URL, direcciones, perfiles, apps, etc.) y grupos de assets. Si llamas a uno de ellos con una clave de solo lectura, se devuelve 403 Forbidden con un mensaje como este:
El permiso de una clave no se puede cambiar después de crearla. Para obtener acceso de escritura, crea una clave nueva con Read & write seleccionado, cambia tu integración para que la use y luego revoca la clave anterior.
Las organizaciones de integración solo pueden crear claves de solo lectura. Si tu organización necesita acceso de escritura, escribe a support@chainpatrol.io.