Skip to content

Query Device Details

API Address:/v2/devicemgr/r3/openapi/device/detail

Request Method:GET

Request Data Type:application/x-www-form-urlencoded

Response Data Type:*/*

API Description: Device details query

Request Parameters:

Parameter NameParameter DescriptionRequest TypeRequiredData TypeSchema
deviceKeyDevice deviceKeyquerytruestring
productKeyProduct productKeyquerytruestring

Response Status:

Status CodeDescriptionSchema
200OKActionResultOfDeviceDetails
401Unauthorized
403Forbidden
404Not Found
50000Service exception
50005Parameter check error
70000Hub service unavailable
70089You have limited permission to operate this project or product or device
70130Non-existent device
91001Token does not exist
91004Token incorrect
91005Doesn't have permission
91006User not in IP white list
91007Please enable API permission

Response Parameters:

Parameter NameParameter DescriptionTypeSchema
codeReturn codeobject
dataObjectDevice detailsDevice details
  activedTimeDevice activation timeinteger(int64)
  authModeAuthentication method, 0-Dynamic authentication 1-Static authentication 2-X509, default 0integer(int32)
  createTimeCreation timeinteger(int64)
  dataFmtData format: 0-Transparent transmission, 3-Thing modelinteger(int32)
  deviceKeyDevice DKstring
  deviceNameDevice namestring
  deviceStatusDevice status: 1-Online, 0-Offlineinteger(int32)
  firstConnTimeFirst connection timeinteger(int64)
  isActivedWhether activated: 0-Not activated, 1-Activatedinteger(int32)
  isVerifiedSecondary authentication: 0-Not authenticated, 1-Authenticatedinteger(int32)
  isVirtualWhether virtual device: 0-Real, 1-Virtualinteger(int32)
  lastConnTimeLast online timeinteger(int64)
  lastOfflineTimeLast offline timeinteger(int64)
  productKeyProduct PKstring
  snDevice SNstring
  updateTimeUpdate timeinteger(int64)
exp1string
msgPrompt messageobject
pageNumCurrent page numberobject
pageSizeItems per pageobject
pagesTotal pagesobject
totalTotal countobject

Response Example:

javascript
{
    "code": 200,
    "data": {
        "activedTime": 1748944587349,
            "authMode": 0,
            "createTime": 1744179122906,
            "dataFmt": 3,
            "deviceKey": "DK00001",
            "deviceName": "DdevicName01",
            "deviceStatus": 1,
            "firstConnTime": 1744179201775,
            "isActived": 1,
            "isVerified": 1,
            "isVirtual": 0,
            "lastConnTime": 1748922175239,
            "lastOfflineTime": 1747316156218,
            "productKey": "PK0001",
            "sn": "SN00001",
            "updateTime": 1748944587349
    },
    "msg": ""
}