cs-utilities-system-api-services
La API de Utilidades del Sistema ofrece acceso seguro a funciones clave como operaciones sobre tablas, mensajería, seguridad, gestión de archivos, servicios de seguros y procesamiento de reclamaciones, facilitando la administración eficiente del sistema
home
🛠cs-utilities-system-api-services
Esta API ofrece un amplio conjunto de utilidades y servicios de apoyo para la integración de aplicaciones y sistemas. Incluye endpoints para:
- Consultas de tablas básicas y configuración
- Servicios de mensajería por correo electrónico
- Generación y validación de Contraseñas de Un Solo Uso (OTP)
- Gestión de notificaciones y servidores SMTP
- Operaciones de datos relacionados con seguros
- Carga y descarga de archivos (archivos compartidos, blobs)
- Consultas de reclamos y CosmosDB
- Reportes de uso para aplicaciones web
Todos los servicios están asegurados vía OAuth 2.0 y siguen estándares comunes para integraciones robustas.
🌐 Información Base
- Título de la API: system-utilities-api
- Versión: 1.0.0
- URL Base:
https://utilities-system-api-{env}.us-e1.cloudhub.io/api/
🚀 Cómo Comenzar
- Autenticación: Asegúrate de tener un
client_id
válido y token BearerOAuth 2.0
. - URL Base: Prefija todos los endpoints con la URL base.
- Encabezados: Usa los siguientes encabezados en tus solicitudes:-H "client_id: TU_CLIENT_ID"-H "Authorization: Bearer TU_ACCESS_TOKEN"-H "Content-Type: application/json"
📍 Endpoints Disponibles
Método | Endpoint | Descripción | Enlace Exchange |
---|---|---|---|
GET | /Utilities/v1/basicTables/(action) | Consultar tablas básicas por acción | Ver en Exchange |
GET | /Utilities/v1/basicTables/(action)/(id) | Consultar detalle de tabla básica por ID | Ver en Exchange |
POST | /file/share | Compartir un archivo | Ver en Exchange |
POST | /files/blobs | Subir blobs de archivos | Ver en Exchange |
POST | /files/shares | Crear un recurso compartido de archivos | Ver en Exchange |
GET | /files/shares | Obtener recursos compartidos de archivos | Ver en Exchange |
GET | /files/blobs | Obtener blobs de archivos | Ver en Exchange |
GET | /claims | Consultar reclamos | Ver en Exchange |
POST | /cosmos/query | Ejecutar consulta en Cosmos DB | Ver en Exchange |
GET | /security/otpcode | Generar código OTP | Ver en Exchange |
GET | /notification/email/smtp | Enviar notificación vía SMTP | Ver en Exchange |
POST | /security/otpcode/validate | Validar código OTP | Ver en Exchange |
GET | /insurance/life/rates/payment-freq | Obtener frecuencia de pago de seguros de vida | Ver en Exchange |
GET | /insurance/home/combos-coverages | Obtener coberturas y combos de seguros de hogar | Ver en Exchange |
GET | /insurance/channel/product | Obtener productos disponibles por canal | Ver en Exchange |
POST | /web-api/report-use/register-data | Registrar uso de reportes en Web API | Ver en Exchange |
POST | /insurance/issuing-of-policy/save | Emitir póliza de seguro | Ver en Exchange |
POST | /register-audit-log | Registrar auditoría de logs | Ver en Exchange |
GET | /gateway-services-azure/product-information | Consultar información de producto en Azure | Ver en Exchange |
POST | /encryptPdfWithPassword | Encriptar PDF con contraseña | Ver en Exchange |
POST | /gateway-services-azure/storageDocumentPolicySigned | Guardar documento de póliza firmada en Azure | Ver en Exchange |
POST | /gateway-services-azure/registry-encrypt | Registrar documento encriptado en Azure | Ver en Exchange |
📤 Ejemplo de Solicitud (Genérico)
curl -X POST "https://utilities-system-api-{env}.us-e1.cloudhub.io/api/<endpoint>" \
-H "client_id: TU_CLIENT_ID" \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "key": "value" }'
Reemplaza <endpoint>
y la carga útil según sea necesario para el recurso específico.
⚠️ Manejo de Errores
Esta API sigue códigos de estado HTTP estándar para todas las respuestas:
200 OK
– La solicitud fue procesada exitosamente400 Bad Request
– Parámetros inválidos o faltantes401 Unauthorized
– Autenticación fallida404 Not Found
– El endpoint o recurso especificado no existe500 Internal Server Error
– Error inesperado del lado del servidor
📞 Soporte
Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.
Correo electrónico: epalma@fgs.co
📅 Información Adicional
- Documentación actualizada por última vez: Septiembre 2025
- Para actualizaciones adicionales, consulta el Portal de Exchange de API
Documentación actualizada en septiembre 2025 por epalma@fgs.co - Edna Nayibe Palma
© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API system-utilities-api