GGRC Software · DocumentaciónEntrar a la aplicación

Integración con GRC Software

Consume los datos de tu empresa desde tus propios sistemas. Esta guía describe lo que la plataforma hace hoy; donde algo todavía no se puede hacer, lo dice.

En una página

La plataforma expone una API REST bajo /api/v1. Te autenticas con una clave de API que creas desde la aplicación, y esa clave queda atada a una empresa: todo lo que consultes con ella son datos de esa empresa y de ninguna otra.

bash

curl -X POST https://app.grclaft.com/api/tx-monitor/ingest \
  -H "x-tenant-api-key: grc_tu_clave_aqui" \
  -H "content-type: application/json" \
  -d '{"reference":"TX-2026-001","txType":"WIRE_INTERNATIONAL",
       "channel":"ONLINE","amount":15000,"currency":"USD",
       "occurredAt":"2026-09-21T14:32:00Z"}'

No hay un parámetro para indicar de qué empresa quieres los datos, y es a propósito: la empresa la determina la clave, no quien llama. Ver Aislamiento por empresa.

Antes de empezar

Necesitas tres cosas, en este orden:

  1. Una cuenta en una empresa activa en la plataforma, con permiso para administrar claves de API.
  2. Una clave creada en Ajustes → Claves de API. Se muestra una sola vez.
  3. Un sitio seguro donde guardarla en tu lado. Una clave en un repositorio es una clave filtrada.

Estado actual de la API

No todos los endpoints aceptan clave de API todavía

Hoy la autenticación por clave está habilitada en los endpoints de ingesta —monitoreo transaccional y blockchain—. El resto de /api/v1 responde a una sesión de navegador, es decir, funciona desde la aplicación pero no desde un proceso tuyo.

Está escrito aquí en vez de omitirlo porque la diferencia se descubre a la primera petición, y preferimos que la descubras leyendo. En Endpoints está marcado cuál es cuál.

Por dónde seguir

Autenticación

Cómo se crea una clave de API, cómo se envía y qué pasa cuando caduca o se revoca.

Aislamiento por empresa

Por qué una clave solo puede ver los datos de su propia empresa, y cómo se garantiza.

Endpoints

Qué módulos expone la API, con qué forma de respuesta y qué acepta cada uno hoy.

Errores y límites

Códigos de estado, forma de los errores y el límite de peticiones por clave.

Seguridad

Cómo se guardan las claves, qué queda auditado y qué hacer si una se filtra.