Developers
Una API pública para cerrar loops de decisión, no solo leer dashboards.
FUVIHUB expone /api/v1/* con scopes granulares, rate-limits por tier, paginación por cursor, webhooks firmados con HMAC-SHA256 y un SDK TypeScript tipado. Preview mode incluido para probar sin cuenta ni credenciales externas. Si tu equipo construye software que necesita consumir inteligencia con evidencia — este es el backbone.
Ingest
POST /api/v1/feedback para entregar señales una por una o en batch. Dedup por externalId, idempotente, preview sin credenciales.
Read & control
Insights, alertas, reviews, schedules y targets. Endpoints REST tipados, paginación por cursor y errores con códigos estables.
Webhooks firmados
Cada entrega lleva X-Veil-Signature (HMAC-SHA256) para verificar sin confiar en la red. Retry + replay expuestos vía API y UI.
Audit & governance
Políticas de organización, SCIM Groups con role binding, SSO por SAML u OIDC. Todo en /api/v1 para operar programáticamente.
Quick start
Del signup al primer POST en 3 pasos.
- 1
Crea workspace
Plan Launch gratis; seed con datos demo cargado para que veas ingesta, review, briefings y alertas desde el minuto cero.
- 2
Genera una API key
Settings → Platform API keys. Elige los scopes mínimos que tu integración necesita. La clave solo se muestra una vez.
- 3
Envía tu primera señal
POST
/api/v1/feedbackconAuthorization: Bearer <key>. Respuesta idempotente con el id interno ya clasificado.
Ejemplo mínimo
curl -X POST https://fuvihub.com/api/v1/feedback \
-H "Authorization: Bearer fuvihub_live_<prefix>_<secret>" \
-H "Content-Type: application/json" \
-d '{
"source": "market-watch",
"content": "La demanda se está tensionando en tres regiones esta semana.",
"occurredAt": "2026-04-25T04:40:03.885Z"
}'Legacy: las claves veil_* siguen siendo válidas mientras migras. Headers de webhook mantienen el contrato X-Veil-* para no romper consumidores existentes.
Why build on FUVIHUB
Seis razones por las que un equipo técnico nos elige como backbone.
No vendemos "AI platform". Vendemos un backbone de decisión con evidencia citable, scope validado y firma HMAC. Si esto no es lo que tu equipo necesita, no lo compres.
Determinismo con evidencia
Briefs, scoring y scenarios se generan determinísticamente. Dado el mismo input, obtenés el mismo output — trazable, reproducible en CI. Cada respuesta trae evidence[] con signalId, fecha y fuente.
Scopes mínimos, rotables sin downtime
El servidor valida scope por ruta. Tu API key no puede hacer más de lo que pediste. Rotación con grace window; no existe una clave root que cubra todos los scopes.
Firma HMAC en cada webhook
X-Veil-Signature: sha256=... en cada entrega. No confiás en la red, validás la firma. Retry con backoff exponencial y replay manual desde UI y API.
Preview mode sin credenciales
POST /api/v1/feedback contra el sandbox sin cuenta ni key — validás el contrato antes de firmar pricing. SDK TS tipado hasta el campo de evidence.
Compatibilidad hacia adelante
veil_* keys siguen válidas, X-Veil-* headers siguen contractuales. Legacy aliases preservados para no romper integraciones existentes.
No es otra API de feedback
Es el backbone que tu producto consume para cerrar loops automáticos. Scanner + Radar + Briefs + Signals exponibles desde un mismo /api/v1/*.
Cómo se conectan las superficies
Scanner, Radar y Signals en un mismo /api/v1/*.
Cada surface del producto tiene un endpoint REST tipado. El output de Scanner alimenta Radar; las señales alimentan ambas. El operador o tu sistema programáticamente puede cerrar el loop end-to-end.
Scanner
Disparás un scan
POST /api/v1/scans
Análisis estructurado (strengths / weaknesses / risks / opportunities / watch items / next best actions) con evidencia citable, en minutos. Re-run on demand.
Radar
Escalás un hallazgo
POST /api/v1/scenarios
Un risk detectado por Scanner se convierte en scenario vigilado continuamente con windowEnd, drivers y confidence. Webhook cuando los drivers se mueven.
Signals
Alimentás la base
POST /api/v1/feedback
Tickets, reviews, logs, transcripts entran dedupados por externalId. El motor los clasifica, los linkea a temas y los hace consultables desde Scanner y Radar.
Casos de uso por vertical
Cómo otros equipos usan la API — patrones que se repiten.
Seis verticales, seis loops concretos. Cada uno indica qué tier necesita, qué integra, qué cierra y por qué el equipo compró.
SaaS / Product-led
Target: Head of Product / CS
- Integración
- Intercom + Zendesk → POST /api/v1/feedback; pull semanal de /api/v1/insights?theme=onboarding al warehouse.
- Loop automático
- Cuando un driver de churn sube σ configurable, webhook dispara ticket al Head of CS con el brief pre-generado.
- Por qué cierran
- Dejan de armar el Monday digest a mano.
Fintech / Banca
Target: Head of Risk / Compliance
- Integración
- Core banking logs + tickets de CX → ingest bulk; reglas compuestas sobre señales regulatorias.
- Loop automático
- Un risk con evidencia ≥ B genera brief ejecutivo firmado exportable para compliance.
- Por qué cierran
- Audit trail y hash-chain export gobernable por API.
Commerce / Retail
Target: Head of Ops omnichannel
- Integración
- Reviews + tickets POS → feedback API; webhook a Slack de ops por incidencia por tienda.
- Loop automático
- Schedule diario resume rotación + pricing + fulfillment por región.
- Por qué cierran
- Un solo canal donde leer lo que el cliente dice versus lo que el POS mide.
Healthcare
Target: Director of Patient Experience
- Integración
- Portal + CRM + encuestas → ingest; SCIM v2 con Azure AD; audit export firmado mensual.
- Loop automático
- Driver 'tiempo de respuesta' deteriorado → alert gobernada por policy al área correspondiente.
- Por qué cierran
- Governance programática sin build-it-yourself.
Educación superior
Target: Rectorado / Decanato
- Integración
- LMS + CRM de admisiones + reviews públicas; digest weekly a decanos por carrera.
- Loop automático
- Retention driver por cohorte alimenta el brief del rector los lunes.
- Por qué cierran
- Reemplaza a la consultora educativa del semestre.
Dev / Platform team
Target: Staff engineer
- Integración
- API como backbone del producto del cliente; webhooks firmados como fuente de verdad.
- Loop automático
- SDK TS tipado en CI; preview mode para tests sin credenciales.
- Por qué cierran
- No construyen su propia capa de inteligencia — la consumen.
Scopes disponibles
El servidor valida cada request contra los scopes de la API key. Pide el mínimo necesario; puedes rotar o revocar sin downtime. Lista actualizada al deploy:
Tiers comerciales de API
Tres niveles. Mismo motor. Distinta profundidad.
Los tiers técnicos 1×/2×/4× del servidor se exponen como niveles comerciales Básica, Intermedia y Avanzada. No cambian solo la cuota — cambian qué surface podés operar por API. Verpricing para el mapeo plan → tier.
Básica
1× rate-limit
Incluida con Operator ($49/mes). Ingest + read de Scanner, Radar y Briefs. 10 000 señales / mes, 5 schedules, 10 targets. Ideal para automations puntuales.
Alias técnico: base.
Intermedia
2× rate-limit
Incluida con Strategic ($199/mes). Todo lo anterior + escritura en policies, scenarios watch/unwatch, briefs versionados, 100 000 señales, 20 schedules, 50 targets, históricos 365 d.
Alias técnico: professional.
Avanzada
4× rate-limit
Exclusivo Institutional. Todo + SCIM v2, SSO SAML/OIDC, policy gate programático, audit export firmado, embeds firmados, volumen ilimitado. SLA medible con crédito contractual.
Alias técnico: strategic.
docs/api-tiering-and-commercial-mapping.md.Empieza ahora
Crea un workspace y dispara tu primer POST en minutos.
Plan Launch gratis para probar. Operator ($49/mes) habilita API de escritura. Strategic ($199/mes) agrega escritura en policies + briefs versionados. Institutional con contrato para governance.