Para developers

API Docs.

Integrá Guardians AI en tu stack: validación de documentos, comprobantes y comunicaciones antes de que el fraude te cueste dinero. REST API simple, disponible desde el plan Business en adelante.

Acceso

Disponible desde plan Business. API Keys con scopes acotados por permiso.

Auth

API Key por request (header Authorization). Múltiples keys por organización, revocables individualmente.

Webhooks

Notificación automática a tu sistema de pagos cuando se detecta fraude.

Formato

REST + JSON. Multipart para archivos. Respuestas consistentes en snake_case.

Quickstart

Tu primer análisis en 3 minutos

Análisis de una imagen vía cURL. Mismo flujo con cualquier cliente HTTP.

Generá tu API Key

# Desde el dashboard (requiere plan Business o superior):
# https://app.guardiansai.app/account/api-keys
# Elegí un preset de permisos (ej: "analysis_only") o
# seleccioná los scopes que necesitás.

Hacé tu primer request

curl -X POST https://api.guardiansai.app/api/analyze \
  -H "Authorization: Bearer ${GUARDIANS_AI_API_KEY}" \
  -F "file=@imagen.jpg" \
  -F "source_channel=api"

Procesá la respuesta

{
  "analysis_id": "a1b2c3d4-...",
  "score": 87,
  "verdict": "ai_generated",
  "label": "ai_generated",
  "confidence": 0.94,
  "content_type": "image",
  "summary": "Imagen generada por IA con alta confianza",
  "top_signals": [ ... ],
  "quota": {
    "scansUsed": 142,
    "scansLimit": 3000,
    "chargedTo": "plan"
  },
  "processing_ms": "...",
  "analyzed_at": "2026-07-20T22:16:05.690Z"
}

Nota: el identificador del análisis viaja en el campo analysis_id, no en id.

Autenticación

API Keys con permisos acotados

Cada organización puede crear varias API Keys — por ejemplo, una para producción y otra para staging — cada una con solo los permisos (scopes) que necesita. Si una key se filtra, el daño queda acotado a lo que esa key puede hacer. Las keys se revocan individualmente sin afectar al resto de tu integración.

Scope	Permite
analyze:write	Enviar contenido a analizar (POST /api/analyze)
analyze:read	Leer análisis previos y su historial
validate:write	Pre-validación de pagos (POST /api/validate)
certificates:write	Emitir certificados legales de un análisis
certificates:read	Listar y descargar certificados emitidos
contacts:read / contacts:write	Leer o gestionar la base de contactos
payment_webhooks:manage	Configurar los webhooks de bloqueo de pagos

SDK

SDK oficial de Node.js

Cliente tipado (JavaScript + TypeScript) que envuelve todos los endpoints de la API, con manejo de errores consistente. Requiere Node.js 18 o superior.

Instalación

npm install github:Guardiansailatam/guardians-ai-node-sdk

Uso

const GuardiansAI = require('guardiansai-node');

const client = new GuardiansAI({ apiKey: process.env.GUARDIANS_AI_API_KEY });

const result = await client.analyze({
  file: fs.readFileSync('./comprobante.pdf'),
  filename: 'comprobante.pdf',
});

console.log(result.score, result.verdict);

Código fuente y documentación completa del SDK: github.com/Guardiansailatam/guardians-ai-node-sdk

Rendimiento

Medimos cada respuesta

Cada análisis registra su propio tiempo de procesamiento (processing_ms en la respuesta), y calculamos los percentiles P95 y P99 por tipo de contenido a partir de datos reales de producción — sin estimaciones. Estas métricas se publican de forma agregada en esta página a medida que el volumen por tipo de contenido crece.

Endpoints principales

REST API

POST/api/analyzeAnalizar imagen, video, audio, PDF o texto

GET/api/analyze/{analysis_id}Obtener detalle de un análisis previo

GET/api/analyzeListar análisis (paginado, filtros)

POST/api/validatePre-validación de pagos: approve / review / block

POST/api/certificatesEmitir certificado legal de un análisis

GET/api/certificates/verify/{id}Verificación pública de un certificado (sin auth)

GET/api/payment-block-webhooksGestionar webhooks de bloqueo de pagos

Caso de uso destacado

Pre-validación antes de mover dinero

POST /api/validate analiza comprobantes, facturas, audios de autorización y comunicaciones asociadas a una operación, y devuelve una decisión clara — approve, review o block — antes de que el pago se procese. Pensado para integrarse en el flujo de aprobación de pagos de bancos, aseguradoras, fintechs y cualquier empresa que mueva dinero a proveedores o terceros.

Ejemplo de respuesta

{
  "decision": "block",
  "decision_reason": "Contenido sospechoso de manipulación/generación por IA",
  "max_score": 84,
  "confidence": 0.91,
  "payment_id": "pay_8821",
  "most_suspicious_item": { "filename": "factura.pdf", "score": 84 },
  "files_analyzed": [ ... ],
  "total_ms": "..."
}

Automatización

Webhooks de bloqueo de pagos

Configurá uno o más webhooks para que, ante fraude detectado, Guardians AI notifique automáticamente a tu sistema de pagos con la acción a tomar: block (bloqueá el pago), hold (retené, pendiente de revisión humana) o release (liberá, ya se revisó y es legítimo). Guardians AI no toca tu pago directamente — le envía la señal a tu sistema, que decide cómo actuar. Compatible con formato genérico o adaptado a MercadoPago, Stripe, PayPal, o un mapeo personalizado.

Firma HMAC-SHA256 opcional para verificar el origen del webhook
Reintentos automáticos con backoff exponencial ante fallas de tu endpoint
Idempotencia por evento — un mismo bloqueo nunca se dispara dos veces
Log completo de cada invocación, disponible vía API o dashboard

¿Necesitás soporte de integración?

En Enterprise incluimos gerente de cuenta dedicado y soporte de ingeniería para tu integración.

Hablar con ingeniería