Información general
¿Qué es el Portal para Desarrolladores del Grupo INS?
Es un espacio que centraliza información, herramientas y recursos para facilitar la integración de servicios y soluciones digitales del Grupo INS.
¿Quiénes pueden utilizar el portal?
El portal está dirigido a socios comerciales, intermediarios, proveedores tecnológicos y organizaciones que requieran integrar servicios del Grupo INS.
¿Es necesario registrarse o iniciar sesión para consultar las APIs disponibles?
No. La información de las APIs habilitadas para uso comercial puede consultarse sin necesidad de iniciar sesión.
¿Qué APIs se encuentran disponibles actualmente?
Se encuentran disponibles aquellas APIs que estén identificadas con la leyenda de disponibilidad comercial correspondiente.
¿Dónde puedo obtener la documentación técnica de una API?
La documentación técnica es suministrada por el ejecutivo o contacto asignado por el Grupo INS.
Recursos y documentación
¿Qué es el Marco de Interoperabilidad del Grupo INS?
Es un conjunto de lineamientos, estándares y documentos que facilitan la interoperabilidad e integración de soluciones con el Grupo INS.
¿Cómo puedo mantenerme informado sobre las novedades del portal?
La sección Novedades y Recursos publica actualizaciones, mejoras, nuevas funcionalidades y contenido de interés para los usuarios del portal.
Autenticación y seguridad
¿Qué necesito para consumir una API protegida?
Debe contar con las credenciales proporcionadas por el Grupo INS, incluyendo un client_id, un client_secret y una subscription-key.
¿Cómo obtengo un token de acceso?
Debe realizar una solicitud HTTP POST al servidor de autorización utilizando el flujo client_credentials.
¿Cuánto tiempo permanece vigente un token de acceso?
La vigencia del token está definida por el atributo expires_in incluido en la respuesta del servidor de autorización.
¿Qué sucede cuando el token de acceso expira?
Las solicitudes realizadas con un token expirado serán rechazadas y retornarán un código HTTP 401 (Unauthorized).
¿Por qué puedo recibir errores de autorización si el token es válido?
Algunas APIs requieren, además del token de acceso, una subscription-key válida asociada al consumidor.
¿La subscription-key reemplaza el token de acceso?
No. Ambos mecanismos cumplen funciones distintas y son requeridos simultáneamente para consumir una API.
Ambientes y credenciales
¿Qué diferencia existe entre los ambientes de integración y producción?
El Grupo INS dispone de ambientes independientes para pruebas e implementación productiva, cada uno con configuraciones y endpoints de autenticación específicos.
¿Puedo utilizar las mismas credenciales en integración y producción?
No. Cada ambiente dispone de credenciales propias y gestionadas de forma independiente.
¿Cómo puedo obtener credenciales para un ambiente específico?
Las credenciales son proporcionadas por el Grupo INS según el ambiente y la API autorizada para cada organización.