Fichas de acceso

CIQ DEX (Digital Experience Intelligence) proporciona un conjunto de APIs que permiten el acceso programático a datos de rendimiento y experiencia recogidos de dispositivos monitorizados, permitiendo la integración de esta información en sistemas externos.
Para garantizar un acceso seguro y controlado a estos datos, CIQ DEX utiliza tokens de autenticación. Estos tokens actúan como credenciales seguras que sustituyen el uso de nombres de usuario y contraseñas en las llamadas a la API, permitiendo al sistema identificar quién realiza las solicitudes.

Este documento describe cómo crear tokens de acceso y muestra las principales formas de utilizarlos con las API DEX de CIQ .

Los tokens de acceso se crean dentro del portal administrativo CIQ DEX.
Siga los pasos que se indican a continuación:

• Acceso "CIQ DEX> Configuración administrativa> Claves de acceso
• Haga clic en "Crear Token".
• Introduzca el nombre, la descripción y la fecha de caducidad del token.
• ¡Crea!

• Después de crear el token, cópielo inmediatamente: no volverá a aparecer. Si lo pierdes, tendrás que generar un nuevo token.

• Utilice este token para realizar solicitudes a las API DEX de CIQ .

El token de acceso es esencial para interactuar con las API REST de CIQ DEX, permitiendo la recopilación automatizada de datos y la integración con otras plataformas.
A continuación se muestran algunos ejemplos prácticos de cómo se pueden utilizar los tokens.

En /v1/api/ciq/machineInfo permite recuperar información sobre los dispositivos asociados a un empleado concreto.
Ejemplo:

GET /v1/api/ciq/machineInfo?search=email@company.com
Authorization: Bearer <your_token>

Respuesta esperada:

{
  "status": true,
  "data": {
    "deviceCount": 1,
    "devices": [
      {
        "machineId": "M123456",
        "machineName": "LAPTOP-XYZ"
      }
    ]
  }
}

Este endpoint es útil para identificar los dispositivos monitorizados y recoger sus correspondientes identificadores (machineId).

En /v1/api/ciq/metrics devuelve métricas detalladas sobre el rendimiento y la experiencia digital de un dispositivo específico.

Ejemplo de solicitud:

GET /v1/api/ciq/metrics?machineId=M123456&startDate=2025-10-01&endDate=2025-10-06
Authorization: Bearer <your_token>

Ejemplo de respuesta (simplificada):

{
  "machineInfo": {
    "name": "LAPTOP-XYZ",
    "osName": "Windows 11",
    "manufacturer": "Dell",
    "model": "Latitude 5420"
  },
  "scores": {
    "cpu": { "score": 87 },
    "memory_usage": { "score": 92 },
    "overall": { "score": 89 }
  }
}

Estos datos pueden utilizarse para:

• Supervisa el rendimiento y la salud del dispositivo;
• Alimentar los cuadros de mando corporativos i

Swagger LAD1
Swagger LAD2