Cloud API v1

Descripción general

La API Cloud expone los datos de procesamiento de dispositivos de HiTekNova mediante HTTPS en formato JSON. Cada endpoint acepta una solicitud POST con cuerpo JSON y devuelve una respuesta JSON. Todos los endpoints de consulta requieren un JWT Bearer obtenido desde RegisteredToken.

URL base y autenticación

Todos los endpoints comparten la misma URL base. Pase su JWT en el encabezado Authorization.

Authorization header

Authorization: Bearer <JWT>
Content-Type: application/json

Autenticación — RegisteredToken

Intercambie su usuario y contraseña del panel por un JWT. El token incluye su customer_id, por lo que cada llamada posterior queda automáticamente limitada a su cuenta. Los tokens son de larga duración — cachéelos.

Parámetros obligatorios

Ejemplo — Solicitud

curl -X POST https://cloudapi.hiteknova.com/ClientDataAPI/RegisteredToken \
  -H "Content-Type: application/json" \
  -d '{"username":"yourlogin","password":"yourpassword"}'

Respuesta

En caso de éxito, se devuelve el JWT como cadena sin envoltorio JSON. Úselo como Authorization: Bearer <token> en el resto de las llamadas.

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6...

Búsqueda individual — getByImei

Consulte el historial de un único IMEI o número de serie. Coincide con imei_esn o serial_number. Devuelve hasta 100 registros por llamada, paginados mediante fromid.

Parámetros obligatorios

Parámetros opcionales

Ejemplo

curl -X POST https://cloudapi.hiteknova.com/ClientDataAPI/getByImei \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"imei":"356360390499091"}'

Respuesta

{
  "status": 1,
  "msg": "",
  "total": 2,
  "has_more": false,
  "last_id": 60185,
  "data": [ { /* device record */ }, ... ]
}

Todos los endpoints de consulta (getByImei, getByImeiBulk, getAllDevices, getByUser, getByMachine) devuelven registros con la misma estructura. Consulte Campos del registro de dispositivo para la referencia completa.

Búsqueda masiva — getByImeiBulk NEW

Consulte el historial de hasta 100 IMEIs o números de serie en una sola llamada. El indicador latest (por defecto true) devuelve un registro (el más reciente) por cada entrada coincidente en el orden de la solicitud — la ruta más rápida para verificar "¿tengo estos dispositivos?". Use latest: false para obtener el historial completo con paginación por id ASC vía from_id / last_id.

Parámetros obligatorios

Parámetros opcionales

Ejemplo — latest (default)

curl -X POST https://cloudapi.hiteknova.com/ClientDataAPI/getByImeiBulk \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "imeis": ["356360390499091","356360393577562","358991131387944"]
  }'

Ejemplo — full history, paged

{
  "imeis": ["356360390499091"],
  "latest": false,
  "fromdate": "2026-01-01",
  "limit": 100
}

// next page
{
  "imeis": ["356360390499091"],
  "latest": false,
  "from_id": 60190,
  "limit": 100
}

Ejemplo — filters

{
  "imeis": ["356360390499091","356360393577562"],
  "latest": false,
  "erase_result": "passed",
  "os_type": "Android",
  "model_name": "Galaxy S24",
  "fromdate": "2026-01-01",
  "todate": "2026-04-15"
}

Respuesta

{
  "status": 1,
  "msg": "",
  "total": 3,
  "has_more": false,
  "last_id": 60185,
  "data": [
    {
      "id": 60184,
      "IMEI": "356360393577562",
      "IMEI2": "357332263577567",
      "SerialNumber": "R5CXB08H4PJ",
      "ModelName": "Galaxy S24 FE",
      "Capacity": "256GB",
      "RAM": "8GB",
      "BatteryMaxCapacity": "98%",
      "ErasureStatus": "Passed",
      // ... see Device Record Fields below
    }
  ]
}

Listar dispositivos — getAllDevices

Lista los registros de dispositivos del cliente autenticado, filtrados por fecha y tipo de reporte. Devuelve hasta 100 registros, paginados por fromid.

Parámetros opcionales

Ejemplo

curl -X POST https://cloudapi.hiteknova.com/ClientDataAPI/getAllDevices \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"fromdate":"2026-03-01","todate":"2026-04-15","report_type":"erase"}'

Respuesta

{
  "status": 1,
  "msg": "",
  "total": 100,
  "has_more": true,
  "last_id": 60110,
  "data": [ { /* device record */ }, ... ]
}

Todos los endpoints de consulta (getByImei, getByImeiBulk, getAllDevices, getByUser, getByMachine) devuelven registros con la misma estructura. Consulte Campos del registro de dispositivo para la referencia completa.

Consultar por usuario — getByUser

Lista los registros creados por un operador específico (username). Útil para reportes por técnico.

Parámetros obligatorios

Parámetros opcionales

Ejemplo

curl -X POST https://cloudapi.hiteknova.com/ClientDataAPI/getByUser \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "username":"operator01",
    "fromdate":"2026-03-01",
    "todate":"2026-04-15",
    "fromid":0,
    "report_type":"all",
    "data_format":1
  }'

Consultar por máquina — getByMachine

Lista los registros procesados en una máquina TestPod específica (machine_sn).

Parámetros obligatorios

Parámetros opcionales

Ejemplo

curl -X POST https://cloudapi.hiteknova.com/ClientDataAPI/getByMachine \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "machine_sn":"TP-001234",
    "fromdate":"2026-03-01",
    "todate":"2026-04-15",
    "fromid":0,
    "report_type":"all"
  }'

Mapeo de SKU — getSku

Obtiene la tabla de mapeo de SKU de su cuenta. Devuelve filas sku, sku_1, sku_2 utilizadas para enriquecer las respuestas de getBy*.

Ejemplo

curl -X POST https://cloudapi.hiteknova.com/ClientDataAPI/getSku \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{}'

Respuesta

{
  "status": 1,
  "data": [
    { "sku": "SKU001", "sku_1": "Alias A", "sku_2": "Alias B" }
  ]
}

Campos del registro de dispositivo

Cada registro devuelto por los endpoints de consulta tiene la siguiente estructura. Los campos pueden estar vacíos cuando el valor no está disponible.

Manejo de errores

En caso de fallo, los endpoints devuelven status: 0 y un msg legible. En caso de éxito, status: 1.

{
  "status": 0,
  "msg": "Data format incorrect"
}

Soporte

¿Necesita una cuenta, un nuevo token o ayuda con la integración? Contáctenos.

Correo: support@hiteknova.com