Device APIs

1. Prerequisites

Base URL: https://api.rokid.com

• Keep a valid API_KEY for authentication.
• Register the device under Devices on the Lingmou console: https://x-inspection.rokid.com/main/devices

2. Overview

Device APIs expose registration lookup, querying and teardown so integrations can inspect Glass units.

2.1 List devices

Endpoint https://api.rokid.com/ar/core/openapi/device/list

Method POST

Request application/json

Response */*

Parameters

Name	Description	Required	Type
deviceSn	SN substring search	false	string
deviceName	Friendly name substring	false	string

Response fields

Name	Description	Required	Type
deviceSn	Serial number	true	string
deviceName	Device name	true	string
deviceType	GLASS3 enterprise · GLASS3_LITE · GLASS_OTHER …	true	string
status	Connection: online / offline	true	string

Example

curl -X POST https://api.rokid.com/ar/core/openapi/device/list \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "deviceSn":"1901",
    "deviceName":"glass3"
}'

Sample response

{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "deviceName": "glass3_001715",
      "deviceSn": "1901092524001715",
      "deviceType": "GLASS3",
      "status": "offline"
    }
  ],
  "success": true
}