Cloud API v1

Overview

The Cloud API exposes HiTekNova's device processing data over HTTPS as JSON. Every endpoint takes a POST request with a JSON body and returns a JSON response. All data-querying endpoints require a Bearer JWT obtained from RegisteredToken.

Base URL & Authentication

All endpoints share the same base URL. Pass your JWT in the Authorization header.

Authorization header

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

Authentication — RegisteredToken

Exchange your dashboard username and password for a JWT. The token embeds your customer_id, so every subsequent call is automatically scoped to your account. Tokens are long-lived — cache them.

Required parameters

Example — Request

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

Response

On success the raw JWT string is returned in the body (no JSON wrapper). Use it as Authorization: Bearer <token> on every other call.

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6...

Single Lookup — getByImei

Look up history for a single IMEI or serial number. Matches either imei_esn or serial_number. Returns up to 100 records per call, paginated via fromid.

Required parameters

Optional parameters

Example

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

Response

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

All query endpoints (getByImei, getByImeiBulk, getAllDevices, getByUser, getByMachine) return records with the same shape. See Device Record Fields for the complete field reference.

Bulk Lookup — getByImeiBulk NEW

Look up history for up to 100 IMEIs or serial numbers in one call. The latest flag (default true) returns one newest record per matched input in request order — the fastest path for "do I have these devices?" checks. Set latest: false for full history with id ASC paging via from_id / last_id.

Required parameters

Optional parameters

Example — 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"]
  }'

Example — full history, paged

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

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

Example — filters

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

Response

{
  "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
    }
  ]
}

List Devices — getAllDevices

List device records for the authenticated customer, filtered by date and report type. Returns up to 100 records, paginated via fromid.

Optional parameters

Example

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"}'

Response

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

All query endpoints (getByImei, getByImeiBulk, getAllDevices, getByUser, getByMachine) return records with the same shape. See Device Record Fields for the complete field reference.

Query by User — getByUser

List records created by a specific operator (username). Use for per-technician reports.

Required parameters

Optional parameters

Example

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
  }'

Query by Machine — getByMachine

List records processed on a specific TestPod machine (machine_sn).

Required parameters

Optional parameters

Example

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"
  }'

SKU Mapping — getSku

Fetch the SKU mapping table for your account. Returns sku, sku_1, sku_2 rows used to enrich getBy* responses.

Example

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

Response

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

Device Record Fields

Every record returned by the query endpoints has the following shape. Fields may be empty strings when a value is not available.

Error Handling

On failure, endpoints return status: 0 and a human-readable msg. On success, status: 1.

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

Support

Need an account, a new token, or help integrating? Contact us.

Email: support@hiteknova.com