device.detail.page (Paged device detail)

device.detail.page: Paged device detail

What it does

Paged device detail. Not in device.capability.list. Same capabilityIds[] and Boolean vs 0/1 rules as Batch detail by device ID.

Request URL

POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.detail.page

Returns devices visible to the token: filter by source (bind / share / bindAndShare); sub-account requires openid and authorization table paging. Same scope as batch detail, not “any token sees all account devices”.

Request parameters

Name	Type	Required	Default	Valid values	Description
`token`	String	yes			accessToken
`page`	Int	yes		≥1	Page number
`pageSize`	Int	yes		1–50	Page size
`source`	String	no	`bindAndShare`	`bind` / `share` / `bindAndShare`	Source filter
`openid`	String	no			Sub-account

Request example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system": {
 "ver": "1.0",
 "appId": "lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time": 1706511734,
 "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
 },
 "params": {
 "token": "<yourAccessToken>",
 "page": 1,
 "pageSize": 10,
 "source": "bindAndShare"
 }
}

Response data fields

Same deviceList[] / channelList[] shapes as Batch detail by device ID.

Response example

See Batch detail by device ID.

Error codes

This method may return the codes below. See Return codes and Capability errors for the full catalog.

Gateway and auth (SN / TK / OP)

Code	Meaning	Next step
`SN1001`	Signature error	Check `sign` per Development specification
`TK1002`	Token invalid or expired	Refresh accessToken
`OP1002`	Missing required parameter	Add required fields
`OP1003`	Invalid parameter	Match this page’s parameter table
`OP1009`	Permission denied	Check token and device bind/share grants
`OP1013`	Total call limit exceeded	Reduce call rate
`OP1014`	Daily per-interface limit exceeded	See Interface call limits
`DV1007`	Device offline	Wait until the device is online

See Return codes · OP/SN/TK for the full catalog.

Sub-accounts (SUB)

Code	Meaning	Next step
`SUB1001`–`SUB1002`	Sub-account lacks API permission	Update policy via addPolicy
`SUB1005`	Sub-account token expired	Refresh subAccountToken
`SUB1006`	No device grant for sub-account	Check `Resource` and device serial
`SUB1008`	Sub-account not bound to app	Create and bind the sub-account first

See Return codes · SUB.

Device query (DV20xx)

Code	Meaning	Next step
`DV2004`	Invalid property value	Check parameter range
:---	:---	:---
`DV2007`	Missing channelId	Add channelId
:---	:---	:---
`LIMIT_DEVICE_NUM`	Device count limit	Reduce page size or scope
:---	:---	:---
`PARAM_ILLEGAL_VALUE`	Invalid parameter	Fix request body
:---	:---	:---
`PERMISSION_DENIED`	Permission denied	Check token and share policy

See Return codes · catalog.