Módulo de Integraciones API

El módulo de Integraciones API es la sección donde puedes crear y administrar las "llaves digitales" necesarias para que otros sistemas o aplicaciones se conecten automáticamente con tu cuenta de Tusdatos.co.

Las llaves digitales son credenciales técnicas únicas (compuestas por un Client ID y un Client Secret) que sirven para que un software externo se identifique y acceda de manera segura a nuestro sistema de integración. Su función es sustituir el uso de contraseñas personales, permitiendo que la comunicación entre sistemas sea automática, cifrada y controlada.

1. ¿Cómo acceder al módulo?

Para entrar a esta sección, sigue estos pasos:

1. Dirígete a la parte superior derecha de la plataforma.
2. Haz clic en el icono de tu nombre o perfil (donde aparecen tus iniciales)
3. Haz clic en la sección de Integraciones API.

2. ¿Qué es la "Autenticación"?

La autenticación es simplemente una comprobación de identidad. Es el proceso mediante el cual nuestra plataforma verifica que el sistema externo que intenta entrar tiene una llave válida creada por ti. Sin esta llave, ningún programa externo puede leer o enviar información a tu cuenta.

El módulo se divide en dos pestañas según lo que necesites:

• Autenticación por Tokens (Básica): Es la forma más directa de conectar sistemas. Está disponible para todos los planes y permite crear una llave rápida solo dándole un nombre. 
  
• OAuth 2.0 (Avanzada): Es una opción de mayor seguridad para empresas que necesitan control total. Permite decidir qué permisos exactos tiene cada llave (por ejemplo, solo ver datos o también descargarlos) y ofrece una pestaña de Log de Actividad para revisar cada movimiento realizado con filtros de fecha y paginación. Es nuestra solución de alta seguridad para empresas con necesidades de cumplimiento y auditoría.

  • Permisos a medida: Puedes decidir exactamente qué puede hacer cada llave (por ejemplo: "solo lectura" o "solo descargas").

  • Trazabilidad: Incluye una pestaña de Log de Actividad donde verás cada consulta realizada, con filtros por fecha y paginación para una revisión detallada.

  • Estado: Un banner informativo te confirmará si tu plan tiene esta función activa.

3. Operaciones que puedes realizar

En ambas pestañas, tendrás el control total de tus accesos mediante estas herramientas:

• Crear nueva credencial: Usa el botón  “Crear nueva credencial” para generar un nuevo acceso de forma instantánea.
• Copiar al portapapeles: Junto al Client ID de tu credencial verás un icono de hojas. Haz clic ahí para copiar el código sin errores de transcripción.
• Activar/Desactivar: El icono de "poder" te permite suspender el acceso de una aplicación temporalmente sin necesidad de borrarla.
• Eliminar: Si una integración ya no se usa, bórrala permanentemente con el icono de la papelera.

Tip de seguridad: El "Client ID" (tu contraseña de API) solo se muestra una vez al crear la credencial. Guárdalo muy bien, ya que por seguridad no podremos mostrártelo de nuevo.

Preguntas Frecuentes

1. ¿Cuál es la diferencia real entre "Tokens" y "OAuth 2.0"?

La diferencia principal es el nivel de control.

• Autenticación por Tokens: Es una llave maestra sencilla que te da acceso general a tus servicios contratados. Es ideal para integraciones rápidas donde tú controlas todo el flujo.
• OAuth 2.0: Es una llave inteligente que permite segmentar permisos. Puedes crear una llave que solo sirva para "leer" y otra para "descargar", además de tener un registro detallado de cada movimiento en la pestaña de Log de Actividad.

2. ¿Por qué no puedo activar la pestaña de OAuth 2.0?

El sistema de OAuth 2.0 es una funcionalidad Premium. Si al intentar acceder ves un banner informativo o el botón de creación deshabilitado, es porque tu plan actual no incluye esta característica avanzada. Para activarlo, puedes contactar a nuestro equipo de soporte o comercial para realizar un upgrade.

3. He perdido mi "Secret ID", ¿puedo recuperarlo?

Por estrictas razones de seguridad, no es posible recuperar un  Secret ID una vez que cierras la ventana de creación. Nosotros no almacenamos esa clave en texto plano. Si la pierdes, deberás eliminar la credencial antigua y generar una nueva para obtener un nuevo código de acceso.

4. ¿Puedo cambiarle el nombre o los permisos a una credencial existente?

No. Para garantizar la integridad de tus integraciones, las credenciales no son editables. Si necesitas cambiar el nombre de una aplicación o modificar sus permisos (scopes), la ruta segura es eliminar la credencial actual y crear una nueva con los parámetros correctos.

5. ¿Qué significa el icono de "Power" en la tabla?

Este interruptor te permite suspender el acceso de una credencial de forma inmediata sin tener que borrarla. Es muy útil si detectas un comportamiento extraño en una integración o si quieres pausar un servicio temporalmente; al apagarlo, cualquier intento de conexión con esa llave será rechazado.

6. ¿Qué información puedo ver en el Log de Actividad?

En la pestaña de Logs (exclusiva de OAuth 2.0), podrás auditar cada llamado que haga tu sistema externo. Verás la fecha exacta, la aplicación que usó la llave y el permiso que utilizó. Además, cuentas con filtros de tiempo para revisar qué pasó "Hoy" o en los "últimos 7 días".