Eye4Cloud Open Platform Device Management Documentationv1.1.15

2.1.15 Bind Device to User (supported only by the new Open Platform firmware)

The device must be online. This API binds the user and delivers the private password. It takes effect only on the first delivery; repeated deliveries have no effect. Reset the device before delivering it again.

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

Request Data

Field Name	Type	Required	Description
device_id	string	Yes	Device ID
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
imei	string	No	Device IMEI; an empty string can be passed
data	string	No	Custom data; an empty string can be passed
password	string	Yes	Set the Open Platform Mode Password
uid	string	Yes	Bind User ID
area	int	Yes	Device region: 0=unknown, 1=China, 2=Southeast Asia (including Hong Kong, Macao, and Taiwan), 3=United States, 4=Europe
offset	int	Yes	Number of seconds to add to UTC to obtain local time
timeZone	string	No	Time zone; defaults to Asia/Shanghai when omitted

Request Example

JSON

{
    "device_id": "xxx",
    "timestamp": 1755685731,
    "nonce": "dask43hfad",
    "sign": "xxxxxxx",
    "password": "",
    "uid": "xxx",
    "area": 1,
    "offset": 28800,
    "timeZone": "Asia/Shanghai"
}

CURL Request Example

CURL

curl 'https://open.eye4cloud.com/xxxxx/open/v1/device/bindUser' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxx",
    "timestamp": 1757472185,
    "nonce": "",
    "sign": "",
    "password": "",
    "uid": "xxx",
    "area": 1,
    "offset": 28800,
    "timeZone": "Asia/Shanghai"
}'

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

Example:

JSON

{
    "error_code": 0,
    "error_message": "success",
    "error_tips": ""
}