Eye4Cloud Open Platform Device Management Documentationv1.1.15

2.1.8 Query Device List

POSTProduction: https://open.eye4cloud.com/{{open_id}}/open/v1/device/list

Request Data

device_id	string	Yes	Unique device ID (IMEI can also be used)
timestamp	int64	Yes	Timestamp in seconds
nonce	string	Yes	Random string, 8-20 characters
sign	string	Yes	See "Sign Generation Examples" for the implementation details The data field when generating sign
imei	string	No	Device IMEI; an empty string can be passed
data	string	No	Custom data; an empty string can be passed
device_name	string	No	Device name
page_size	int	Yes	Items per page (default: 10)
page_index	int	Yes	Current Page

Request Example

JSON

{
  "device_id": "xxx",
  "timestamp": 1755685731 ,
  "nonce": "dask43hfad",
  "sign": "xxxxxxx",
  "page_size": 10,
  "page_index": 1
}

CURL Request Example

CURL

curl 'https://open.eye4cloud.com/xxxxx/open/v1/device/list' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxx",
    "timestamp": 1757472185,
    "nonce": "",
    "sign": "",
    "page_size": 10,
    "page_index": 1
}'

Response Data

Field Name	Type	Description
error_code	int	Status code: 0 indicates success; other values indicate an error
error_message	string	Error message; success indicates a normal response
data	object	{}
data.page_size	int	Items per page (default: 10)
data.page_index	int	Current Page
data.total_number	int	Total Pages
data.limit	int
data.list	int	Query Result Array

Example:

JSON

{
  "error_code": 0,
  "error_message": "success",
  "error_tips": "",
  "data": {
    "page_size": 10,
    "page_index": 1,
    "total_number": 1,
    "limit": 10,
    "list": [
      {
        "id": 14728,
        "device_name": "xxxx",
        "device_id": "xxxx",
        "position": "",
        "created_at": "2026-01-04T14:44:15+08:00"
      }
    ]
  }
}