Introducción

La API de GI2Tech está organizada en torno a REST. Nuestra arquitectura tiene URLs previsibles orientadas a recursos, acepta peticiones codificadas en formularios, devuelve respuestas en JSON y utiliza códigos de respuesta, autenticación y verbos HTTP estándar. Garantizamos un umbral de latencia p95 menor a 45ms en todos nuestros endpoints ubicados en LATAM y US-East.

URLs Base:

Producción: https://api.gi2.tech/
Sandbox (Staging): https://sandbox.api.gi2.tech/

Autenticación

La API de GI2Tech utiliza el estandar OAuth 2.0 Bearer Tokens construidos mediante una clave API proporcionada en tu panel corporativo. Usa tu clave secreta para autenticar las peticiones. No compartas tus claves secretas en áreas públicas como GitHub, código del lado del cliente, etc.

// Header Bearer Estándar
Authorization: Bearer sk_live_8a992bc9...

Webhooks & Eventos Asíncronos

Para operaciones que requieren procesamiento profundo, como el mapeo de redes de AdIntel o el procesamiento conversacional de AgentOS, GI2Tech implementa una arquitectura orientada a webhooks. Envías el payload, recibes un 202 Accepted inmediato, y nuestros clústeres harán POST del resultado computado a tu URL de webhook registrada al terminar.

{ "event_type": "agentos.task.completed", "payload_signature": "sha256=2a98b...", "data": { ... } }

Motor AgentOS

Despliega agentes de IA autónomos capaces de resolver tareas de razonamiento complejas, ejecutar subrutinas a través de tus APIs internas y mantener el contexto en flujos de trabajo de múltiples pasos.

POST /v3/agentos/dispatch

curl -X POST https://api.gi2.tech/v3/agentos/dispatch \ -H "Authorization: Bearer ${GI2_KEY}" \ -d '{ "agent_role": "l1_customer_support", "context": "Usuario solicitando reembolso en el ticket #8892", "allowed_tools": ["fetch_order", "issue_refund"] }'

Motor AdIntel

Inyecta puntuación de comportamiento en tus embudos publicitarios. Envíanos los parámetros en crudo del tráfico y el motor predice la probabilidad del LTV (Life-Time Value) en 30ms, permitiéndote ajustar dinámicamente tus pujas para el Costo de Adquisición (CAC).

POST /v3/adintel/score_click

curl -X POST https://api.gi2.tech/v3/adintel/score_click \ -H "Authorization: Bearer ${GI2_KEY}" \ -d '{ "utm_source": "meta_ads", "click_pattern_vector": [0.4, 0.9, 0.1, 0.05], "time_on_page_ms": 12500 }'

Motor OpsIQ

Analiza logs de datos operativos no estructurados de aplicaciones o sistemas CRM para identificar cuellos de botella en la cadena de suministro y problemas en los flujos de trabajo logísticos a través de agrupamiento por LLMs.

POST /v3/opsiq/analyze_logs

{ "status": "processing", "job_id": "opq_99x312", "webhook_url": "https://tu-api.com/webhooks/opsiq" }

Evaluación FraudShield

Evalúa una transacción de pago de manera heurística y devuelve una decisión explícita (BLOCK, REVIEW, ALLOW) dentro de 40ms.

POST /v2/transactions/analyze

{ "status": "success", "risk_decision": "BLOCK", "risk_score": 93.5, "ttl_ms": 31 }

Acceder al Árbol de Desarrollo (Sandbox)

Si estás evaluando GI2Tech para una arquitectura corporativa, solicita claves limitadas para correr pruebas en el clúster de latencia.

Solicitar Acceso a Sandbox