调用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"
	}
}

错误码

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