cs-security-experience-api-services icon

cs-security-experience-api-services

2.4.x
(0 reviews)
Esta API permite la validación de identidad, gestión de OTP, generación de encuestas, manejo de tokens para portales y verificación en listas negras, todo a través de múltiples versiones que aseguran una autenticación y procesamiento de datos seguros.

🛡️cs-security-experience-api-services

Esta API ofrece servicios robustos de validación de identidad y seguridad empresarial. Incluye endpoints para:

  • Verificación de identidad y teléfono con múltiples proveedores
  • Operaciones avanzadas de Contraseña de Un Solo Uso (OTP)
  • Encuestas de seguridad y gestión de tokens empresariales
  • Integración completa con Experian, Inspektor, Fasecolda, Registraduría, Ariba, TransUnion
  • Evaluación de listas restrictivas y validaciones de autenticación
  • Firma electrónica y gestión de documentos digitales
  • Análisis de riesgo crediticio y financiero

Todos los servicios se exponen a través de versiones organizadas (v1, v3, v4) y proporcionan acceso seguro a validaciones de backend con alta disponibilidad y performance optimizado.

🌐 Información Base

  • Título de la API: cs-security-experience-api-services
  • Versión: 1.0.0
  • Plataforma: MuleSoft Anypoint Platform
  • URL Base Producción: https://security-experience-api-prod.us-e1.cloudhub.io/api/
  • URL Base QA: https://security-experience-api-qa.us-e1.cloudhub.io/api/
  • Protocolo: REST/SOAP
  • Formato de Datos: JSON/XML
  • Autenticación: OAuth 2.0 + Client ID

🚀 Cómo Comenzar

  1. Autenticación: Asegúrate de tener el client_id requerido y el token Bearer OAuth 2.0 para acceso seguro.
  2. URL Base: Usa la URL Base proporcionada como prefijo para todos los endpoints de la API.
  3. Encabezados: Agrega los siguientes encabezados en tus solicitudes de API:-H "Content-Type: application/json"-H "client_id: TU_CLIENT_ID"-H "Authorization: Bearer TU_ACCESS_TOKEN"-H "X-Correlation-ID: TU_CORRELATION_ID" # Opcional pero recomendado para trazabilidad

Mejores Prácticas:

  • ✅ Implementa retry con exponential backoff para manejo de errores
  • ✅ Usa correlation IDs para trazabilidad de transacciones
  • ✅ Valida todos los inputs antes de enviar requests
  • ✅ Implementa logging completo de transacciones
  • ✅ Renueva tokens cada 24 horas por seguridad

🚀 Cómo Consumir

Puedes acceder y consumir esta API a través de las siguientes plataformas:

📍 Endpoints Disponibles

MétodoEndpointDescripciónEnlace Exchange
SOAPCheckBlsOperationValidación en listas restrictivas BLSVer detalles
POST/api/security/check_blsValidación BLS e InspektorVer detalles
POST/api/security/v1/OTP/initializeInicialización de OTPVer detalles
POST/api/security/v1/OTP/validateValidación de OTPVer detalles
POST/api/security/v1/portal/generate_tokenGeneración de token portalVer detalles
POST/api/security/v1/portal/validate_tokenValidación de token portalVer detalles
POST/api/security/v1/survey/generateGenerar cuestionario de seguridadVer detalles
POST/api/security/v1/survey/validateValidar cuestionario de seguridadVer detalles
POST/api/customer/v1/identity/validateValidación de identidadVer detalles
POST/api/v3/security/check_blsValidación BLS v3Ver detalles
POST/api/security/v3/OTP/initializeInicialización OTP v3Ver detalles
POST/api/v3/customer/identity/validateValidación identidad v3Ver detalles
POST/api/security/v3/OTP/validateValidación OTP v3Ver detalles
POST/api/v3/security/portal/generate_tokenGeneración token portal v3Ver detalles
POST/api/v3/security/survey/generateGenerar cuestionario v3Ver detalles
POST/api/v3/security/survey/validateValidar cuestionario v3Ver detalles
POST/api/v3/security/portal/validate_tokenValidación token portal v3Ver detalles
POST/api/security/v3/authentication/businessAutenticación empresarialVer detalles
POST/api/security/v3/authentication/supplierAutenticación proveedorVer detalles
POST/api/v4/customer/identity/portal/generate_tokenGeneración token portal v4Ver detalles
POST/api/v4/customer/identity/portal/validate_tokenValidación token portal v4Ver detalles
GET/api/data-credito/HC2Consulta DataCréditoVer detalles
GET/api/fasecolda/obtainUrlObtener URL FasecoldaVer detalles
GET/api/ariba/obtainPendingSuppliersProveedores pendientes AribaVer detalles
POST/api/assessment-filesManejo de archivos de evaluaciónVer detalles
POST/api/v3/security/restrictiveList/inspektorValidación listas restrictivas InspektorVer detalles
POST/api/identity-and-phone-verificationValidación identidad y teléfonoVer detalles
POST/api/otp-phone-selectionSelección de teléfono OTPVer detalles
POST/api/otp-pin-verification-otp-inputValidación de PIN OTPVer detalles
POST/api/obtaining-and-responding-examObtención y respuesta examen identidadVer detalles
POST/api/identity-validation-statusEstado de validación identidadVer detalles
GET/api/electronic-signature/obtain-transactionObtener transacción firma electrónicaVer detalles
GET/api/electronic-signature/tags-listListado de tags firma electrónicaVer detalles
GET/api/electronic-signature/transaction-listListado de transacciones firma electrónicaVer detalles
GET/api/electronic-signature/token-signioToken firma SignioVer detalles
POST/api/electronic-signature/create-transactionCrear transacción firma electrónicaVer detalles
POST/api/electronic-signature/distribution-transactionDistribuir transacción firma electrónicaVer detalles
POST/api/electronic-signature/link-signing-documentsAsociar documentos firma electrónicaVer detalles
POST/api/electronic-signature/register-signer-transactionRegistrar firmante en transacciónVer detalles
POST/api/electronic-signature/reorder-distributionReordenar distribución firma electrónicaVer detalles
GET/api/creditVisionOneConsulta Credit Vision OneVer detalles
GET/api/creditValidationValidación de créditoVer detalles
GET/api/company-reportReporte de compañíaVer detalles
POST/api/digital-signatureFirma digital GSEVer detalles
GET/api/incomeEstimatorEstimador de ingresosVer detalles

📤 Ejemplos de Uso

Ejemplo de Solicitud

curl --location 'https://security-experience-api-qa.us-e1.cloudhub.io/api/customer/v1/identity/validate' \
  -H "Authorization: Bearer {oauth_token}" \
  -H "client_id: {client_id}" \
  -H "client_secret: {client_secret}" \
  -H "Content-Type: application/json" \
  -d '{
    "IdUserEntity": "ODAwMjI2MTc1LjE=",
    "ParamProduct": "3364",
    "Product": "010",
    "Channel": "001",
    "DataValidation": {
        "Person": {
            "Identification": {
                "Number": "00000000",
                "Type": "1",
                "ExpeditionDate": "1584230400000"
            },
            "LastName": "APELLIDO",
            "FirstName": "NOMBRES"
        }
    }
  }'

⚠️ Manejo de Errores

Se utilizan códigos de estado HTTP estándar para el manejo de errores:

📊 Códigos de Respuesta

CódigoEstadoDescripciónCausa ComúnAcción Recomendada
200✅ OKLa solicitud fue exitosaOperación completada correctamenteContinuar con el procesamiento
400❌ Bad RequestParámetros faltantes o inválidosFormato de datos incorrectoRevisar estructura del JSON y campos requeridos
401🔒 UnauthorizedAutenticación fallidaToken expirado o client_id inválidoRenovar token de autenticación
403🚫 ForbiddenSin permisos suficientesClient_id sin permisos para el endpointVerificar permisos asignados al client_id
404🔍 Not FoundEndpoint o recurso no encontradoURL incorrecta o recurso inexistenteVerificar la URL y documentación
429⏰ Rate LimitedDemasiadas solicitudesExceso de requests por minutoImplementar retry con exponential backoff
500💥 Internal Server ErrorError inesperado en el servidorFallo interno del sistemaContactar soporte técnico con correlation ID
503🛠️ Service UnavailableServicio temporalmente no disponibleMantenimiento o sobrecargaReintentar más tarde

❓ Preguntas Frecuentes

🔑 Error 401 - Unauthorized

  • Síntomas: Respuesta "Authentication failed"
  • Causas: Token expirado, client_id incorrecto, headers malformados
  • Solución: Verificar y renovar credenciales, validar formato de headers

⏰ Error 504 - Gateway Timeout

  • Síntomas: Timeout después de 30 segundos
  • Causas: Servicios externos lentos, sobrecarga del sistema
  • Solución: Implementar timeouts más cortos, usar retry con backoff

📊 Error 429 - Rate Limiting

  • Síntomas: "Too Many Requests"
  • Causas: Exceso de requests por minuto (límite: 100/min)
  • Solución: Implementar queue con rate limiting, espaciar requests

📞 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 mejorada y actualizada en Octubre 2025 por epalma@fgs.co - Edna Nayibe Palma

© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-security-experience-api-services

📋 Nota Importante: Esta documentación se actualiza continuamente. Para la versión más reciente y cambios en tiempo real, consulta siempre el Portal de Exchange oficial.

🔒 Aviso de Seguridad: Nunca compartas credenciales de API en repositorios públicos o documentación. Usa siempre variables de entorno para información sensible y rota tokens regularmente.

Reviews