Las claves API de Fixh IT convierten el software de tu centro de asistencia en una plataforma abierta: desde Empresa > Claves API, tu empresa puede generar y revocar claves API REST v1, que se usan en la cabecera X-API-Key para autenticar las solicitudes al endpoint /api/v1/company/... No es una función solo para programadores aislados: es el puente entre tu taller de reparaciones y el resto de tu ecosistema de software, desde tu web hasta tu programa de contabilidad, desde tu CRM hasta el bot que responde a tus clientes. Por motivos de seguridad, la clave completa se muestra en pantalla una sola vez, justo después de crearla: a partir de ese momento solo es visible en forma enmascarada (el key_prefix), por lo que debe copiarse y guardarse de inmediato en un lugar seguro.
Por qué es importante para un centro de asistencia
Un taller de reparación de móviles y ordenadores rara vez trabaja con una sola herramienta: está el sistema de gestión principal, quizá una tienda online para repuestos, un chatbot que responde a los clientes por WhatsApp o Telegram, un software de contabilidad para la facturación, una herramienta de marketing para campañas de correo. Sin una integración real, toda esta información queda aislada en cada sistema, obligando al personal a introducir los mismos datos varias veces, con el riesgo real de errores de transcripción y retrasos en la comunicación con el cliente. Las claves API REST v1 resuelven precisamente este problema: permiten que un sistema externo se comunique automáticamente con los datos de reparaciones de tu empresa en Fixh IT, leyendo el estado de un ticket, creando nuevas reparaciones desde un formulario online, o actualizando un ticket cuando un técnico marca un trabajo como completado. Para un centro de asistencia que gestiona decenas o cientos de reparaciones al mes, esta integración entre reparaciones de móviles y ordenadores y software externo puede marcar la diferencia entre un flujo de trabajo fluido y uno lleno de pasos manuales duplicados.
En la práctica
Cada clave API generada está asociada a tu empresa (key_type "company") y permite que un sistema externo se autentique frente a las API REST v1 de Fixh IT incluyendo la clave en la cabecera X-API-Key de cada solicitud HTTP. Con este tipo de clave puedes consultar el listado de reparaciones de tu empresa filtrando por tienda, estado o texto de búsqueda, leer el detalle de una reparación concreta, crear nuevas indicando tienda, cliente, técnico, dispositivo, avería detectada, accesorios entregados y presupuesto, o actualizar una reparación existente cambiando su estado, pago, entrega o notas internas. Cada solicitud se filtra siempre automáticamente según la empresa a la que pertenece la clave: un sistema externo nunca puede ver ni modificar datos de otra empresa de la red, ni siquiera por error, porque el control se realiza en el servidor en cada consulta.
Por motivos de seguridad, la clave completa (la cadena secreta real) se muestra en pantalla una sola vez, justo después de crearla: a partir de entonces el sistema solo conserva un hash de la clave y muestra en el listado únicamente su prefijo inicial (key_prefix), suficiente para reconocerla pero no para reutilizarla. Por eso es fundamental copiar la clave de inmediato y pegarla en el archivo de configuración del sistema externo que la usará, antes de cerrar la ventana: si se te olvida, la única solución es revocar esa clave y generar una nueva. Cada clave también muestra su fecha de último uso, útil para saber si una integración sigue activa o si puede desactivarse tranquilamente porque ya no se usa. Si una clave se pierde, se ve comprometida o ya no se necesita, puedes revocarla en cualquier momento desde el listado: una vez revocada deja de funcionar de inmediato, se registra la fecha de revocación y cualquier sistema que la utilizara pierde al instante el acceso a las API, sin necesidad de intervenir en ningún otro sitio.
Junto a las claves de tipo empresa, en el mismo sistema técnico existe también un tipo de clave reservado a los distribuidores de la red Fixh IT, usada para gestionar de forma automática la emisión y el control de los códigos de licencia desde su propio software de gestión: ambos tipos de clave están completamente separados (guardas y permisos distintos), y una clave de empresa nunca puede usarse para operaciones reservadas a distribuidores, ni viceversa.
Guía rápida
- Ve a Empresa > Claves API.
- Crea una nueva clave API asignándole un nombre descriptivo que identifique claramente la integración (por ejemplo "Tienda online de repuestos" o "Bot de soporte por WhatsApp").
- Copia de inmediato la clave completa mostrada en pantalla: no volverá a mostrarse entera después, solo en forma enmascarada.
- Pega la clave en el archivo de configuración del sistema externo, en la variable prevista para la cabecera X-API-Key.
- Configura el sistema externo para que envíe la clave en la cabecera X-API-Key en cada solicitud a /api/v1/company/repairs y a los demás endpoints disponibles.
- Prueba la integración con una llamada de prueba, por ejemplo la lectura del listado de reparaciones, para verificar que la respuesta contiene los datos esperados.
- Revisa periódicamente la fecha de último uso de cada clave para detectar integraciones que ya no están activas.
- Si es necesario, revoca la clave desde el listado para interrumpir de inmediato su uso, por ejemplo al cambiar de proveedor de la web o dejar de usar una herramienta externa.
Casos de uso reales
Formulario de solicitud de reparación en la web. Un taller de reparación de móviles integra en su web un formulario "solicitar reparación": cuando un cliente lo rellena, un script externo llama al endpoint de creación de reparaciones con la cabecera X-API-Key, generando automáticamente un nuevo ticket en el sistema, ya asignado a la tienda correcta y listo para que lo asuma un técnico, sin que nadie tenga que copiar a mano los datos de la web al sistema.
Sincronización con un sistema de contabilidad externo. Una empresa con varias tiendas usa un software de contabilidad separado para la facturación: una integración programada lee cada noche, mediante la clave API, las reparaciones marcadas como pagadas y entregadas en las últimas 24 horas, y las importa al sistema contable para el registro fiscal, evitando la doble introducción manual de datos.
Notificaciones automáticas al cliente vía bot. Un centro de asistencia conecta un bot de mensajería a su sistema: cuando un técnico actualiza el estado de una reparación de "en curso" a "lista para recoger" mediante la API, el bot externo comprueba periódicamente las reparaciones actualizadas recientemente y envía automáticamente un mensaje al cliente, reduciendo las llamadas a la tienda para preguntar por el estado de la reparación.
Consejos y buenas prácticas
Crea una clave API distinta para cada integración, en lugar de reutilizar la misma clave en todas partes: así, si un sistema externo se retira o se ve comprometido, puedes revocar solo esa clave sin tener que reconfigurar todas las demás integraciones. Da a cada clave un nombre descriptivo que recuerde de un vistazo para qué sirve, sobre todo si con el tiempo acumulas varias. Revisa periódicamente la fecha de último uso para detectar claves "olvidadas" vinculadas a sistemas que ya no usas, y revócalas: menos claves activas significan una superficie de ataque más pequeña. Guarda la clave completa en un gestor de contraseñas o en un archivo de configuración protegido, nunca en un documento compartido o en un mensaje de chat.
Errores comunes que hay que evitar
Nunca compartas la misma clave API entre varias integraciones distintas: si en el futuro necesitas desactivar una, corres el riesgo de interrumpir también las demás. No incluyas la clave directamente en el código fuente público de una web o una app: siempre debe guardarse en un archivo de configuración separado y no versionado. No esperes poder recuperar la clave completa después de cerrar la ventana la primera vez: si se te olvida copiarla, la única opción es revocarla y generar una nueva. Por último, no olvides revocar las claves de integraciones retiradas: una clave activa pero sin usar sigue siendo un posible punto de acceso a los datos de tus reparaciones.
Más información
- Fixh Assistant: el chatbot de WhatsApp con Fixh AI para tu centro de servicio técnico
- Escaparate Empresarial: vende online los productos de tu almacen
- Exportar todos los datos de la empresa: reparaciones, documentos, clientes y tickets en un archivo ZIP
Preguntas frecuentes
¿Puedo volver a ver la clave completa después de crearla? No, por seguridad la clave completa solo se muestra al crearla; si la pierdes debes revocarla y generar una nueva.
¿Qué ocurre si revoco una clave API? La clave deja de funcionar de inmediato, se registra la fecha de revocación y el sistema rechaza cualquier solicitud que la utilice.
¿Puedo crear varias claves API para la misma empresa? Sí, puedes generar varias claves, por ejemplo una por cada integración o sistema externo conectado, y revocarlas individualmente sin afectar a las demás.
¿Qué datos puedo leer o escribir con una clave API de empresa? Las reparaciones de tu empresa: puedes listarlas, filtrarlas por tienda o estado, crear nuevas y actualizar el estado, pago, entrega y notas internas de las existentes, siempre limitado automáticamente a tu empresa.
¿Las claves API son distintas de las que usan los distribuidores para las licencias? Sí, existen dos tipos de clave completamente separados: las de empresa para reparaciones y las de distribuidor para gestionar códigos de licencia, con permisos y ámbitos distintos.
¿Hace falta conocimiento técnico para usar las claves API? Sí, la integración requiere que el sistema externo (web, bot, software de terceros) esté programado para enviar solicitudes HTTP con la cabecera X-API-Key: está pensada para desarrolladores o proveedores de software que colaboran con tu centro de asistencia.
