Cargando

Saltar al contenido

Usar UTILIA OS Desarrolladores

Entrar Únete a la lista de espera

Empezar

API

Conectar

Insertar en tu web

Cambios

Cargando la pantalla

¿Aún no usas UTILIA OS?

Únete a la lista de espera

Aviso legal
Privacidad
Cookies

© 2026 UTILIA SERVICIOS IA S. COOP. CAN.

Documentación
Para desarrolladores
Empezar a integrar

Empezar a integrar

Tu primera petición a la API, cómo se autentica, sus límites de uso y cómo tratar los errores.

Entrar en Aplicaciones externas

No todo lo de esta sección está en todos los planes: cada artículo indica en cuáles se incluye. Ver precios

Qué alcanza la API externa

Recibe de

Tu aplicación
Llama desde tu servidor con la clave de API de su aplicación externa.

API externa

Las rutas /api/external/v1, con la clave de tu aplicación.

Envía a

Tickets de soporte
Abre tickets en nombre de tus usuarios y sigue sus respuestas.
CRM
Lee y escribe clientes, contactos y leads.
Finanzas
Emite facturas, monta suscripciones y cobra a tus usuarios.
Presupuestos y firma
Lee las firmas de un presupuesto y gestiona sus comentarios visibles para el cliente.
Gestor de archivos
Sube archivos y adjúntalos a los tickets.

Empieza por aquí

Por dónde empezar a integrar

Haz tu primera petición a la API de UTILIA OS en cinco minutos y elige el camino de tu integración: API REST, SDK o avisos a tu servidor.

General

Primeros 15 minutos con la APIDel alta de la aplicación a tu primer ticket: identificar al usuario, abrir una incidencia, pedir sugerencias de IA, enviar errores y tratar los fallos.

Lo básico de la API

Autenticación con clave de accesoCómo autentica la API externa a tu aplicación con la cabecera X-Api-Key, qué comprueba en cada petición y qué error devuelve cuando algo falla.
Límites de uso y CORSCuántas peticiones admite la clave de tu aplicación, qué pasa al superar el límite y desde qué webs se puede llamar a la API externa.
Errores, identificador de petición y reintentosLa forma común de los errores de la API externa, el catálogo de códigos, cómo seguir una petición con X-Request-Id y cuándo reintentar.
Dónde va cada parámetro: consulta, cuerpo o rutaDónde espera cada endpoint de la API externa sus parámetros (en la ruta, en la consulta o en el cuerpo) para evitar errores 400 y 404.
Errores frecuentes al integrarLos diez errores que más se repiten en las primeras integraciones con la API externa de UTILIA OS y cómo evitarlos.

Arquitectura

Arquitectura y flujos de una integraciónLos cuatro flujos que componen una integración con UTILIA OS: tu aplicación llama, UTILIA OS te avisa, la IA trabaja en segundo plano y una persona autoriza con OAuth.
Arquitectura de la plataformaCómo está construido UTILIA OS: un servicio en la nube compartido por varias organizaciones, con los datos de cada una aislados y los módulos conectados entre sí.
Arquitectura de la facturación centralizadaCómo encajan UTILIA OS, tu aplicación y la pasarela de pago al facturar y cobrar: identificadores, puente de identidad, cobro recurrente y avisos.