调用DescribeDeviceInfo获取设备信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDeviceInfo

系统规定参数。取值:DescribeDeviceInfo

DeviceId String 100

设备ID。

DeviceToken不能同时为空。

DeviceToken String cn.xxxxxxx

设备Token。

DeviceId不能同时为空。

ProjectId String projectTest

项目ID。

RegionId String cn-shanghai

地域ID。

返回数据

名称 类型 示例值 描述
DeviceInfo

返回内容。

DeviceBrand String TmallGenuine

设备品牌

DeviceId String cn.1234567890

设备ID

DeviceModel String X1

设备型号

DeviceModelId Long 10

设备型号ID

DeviceType String 智能家居

设备类型

HardwareId String xxxxxxx

硬件ID

MacAddress String 00:00:00:00:00:00

MAC地址

Name String 我的天猫精灵

设备昵称

ProjectId String projectTest

项目ID

Region String cn

设备所在国家代码

SerialNumber String xxxxxxxx

设备序列号

SoftwareId String xxxxxxxx

软件ID

Status String 1

设备状态

UsageType Integer 0

设备使用性质。

  • 0:私人设备
  • 1:运营或共享设备
UsageTypeDesc String private

设备使用性质描述。

  • private:私人设备
  • business:运营或共享设备
Uuid String xxxxxxxx

设备UUID

Vin String xxxxxxxx

设备车架号(汽车相关产品使用)

RequestId String 9c7a3b09-a69a-43f5-8bf2-84f7119810eb

请求ID。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeDeviceInfo
&DeviceToken=cn.xxxxxxx
&ProjectId=projectTest
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDeviceInfoResponse>
  <RequestId>E94C9864-56FB-44AD-AC0C-A1CEFB332254</RequestId>
	  <DeviceInfo>
		    <DeviceBrand>TmallGenuine</DeviceBrand>
		    <DeviceId>cn.1234567890</DeviceId>
		    <DeviceModel>X1</DeviceModel>
		    <DeviceModelId>10</DeviceModelId>
		    <DeviceType>智能家居</DeviceType>
		    <HardwareId>xxxxxxx</HardwareId>
		    <MacAddress>00:00:00:00:00:00</MacAddress>
		    <Name>我的天猫精灵</Name>
		    <ProjectId>projectTest</ProjectId>
		    <Region>cn</Region>
		    <SerialNumber>xxxxxx</SerialNumber>
		    <SoftwareId>xxxxxx</SoftwareId>
		    <UsageType>0</UsageType>
		    <UsageTypeDesc>private</UsageTypeDesc>
		    <Uuid>xxxxxx</Uuid>
	  </DeviceInfo>
</DescribeDeviceInfoResponse>

JSON 格式

{
	"RequestId":"E94C9864-56FB-44AD-AC0C-A1CEFB332254",
	"DeviceInfo":{
		"Uuid":"xxxxxx",
		"DeviceId":"cn.1234567890",
		"DeviceBrand":"TmallGenuine",
		"SoftwareId":"xxxxxx",
		"DeviceModelId":10,
		"DeviceType":"智能家居",
		"UsageType":0,
		"DeviceModel":"X1",
		"Name":"我的天猫精灵",
		"SerialNumber":"xxxxxx",
		"UsageTypeDesc":"private",
		"MacAddress":"00:00:00:00:00:00",
		"Region":"cn",
		"HardwareId":"xxxxxxx",
		"ProjectId":"projectTest"
	}
}

错误码

访问错误中心查看更多错误码。