调用该接口获取密钥。

路径 /awss/cipher/get
版本号 1.0.8
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
deviceInfoForCipher Struct { "deviceName": "xxxx", "productKey": "xxxx", "productId": "001e7", "cipherType": 3, "random": "00000000000000000000000000000000", "params": { "mac":"xxx" } } JSON对象。其中包含deviceName(设备名称)、productKey(产品Key,非蓝牙设备必传)、productId(设备productKey的十六进制字符串,蓝牙设备必传)、cipherType(生成密钥的类型,为空默认一型一密)、random(随机数)、params(扩展参数,蓝牙设备需要传mac,非蓝牙设备传空map)。
random String 随机数(32字节16进制字符串)。
productKey String 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。
deviceName String 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。
productId String productKey的十六进制字符串。蓝牙设备必传,非蓝牙设备不用传。
cipherType Int 生成密钥的类型。3(表示一型一密);4(表示一机一密)。若为空则默认为一型一密。
params Struct 扩展参数,用于加签。蓝牙设备需要传mac,非蓝牙设备传空map。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误消息。

data String

密钥字符串。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.8",
		"iotToken": "token"
	},
	"params":{
		"deviceInfoForCipher":{
			"deviceName": "xxxx",
			"productKey": "xxxx",
			"productId": "001e7",
			"cipherType":3,
			"random": "00000000000000000000000000000000",
			"params":{
				"mac": "xxx"
			}
		}
	}
}

正常返回示例

JSON格式

{
    "id": "b99e4d58-019e-4d3a-96c1-d978ccb6afcc",
    "code": 200,
    "message": null,
    "localizedMsg": null,
    "data":"sadhoia28h12od09asjk1829dh8"
}

异常返回示例

JSON格式

{
    "id": "166267b9-c15e-4180-8cf5-0081f6552fb0",
    "code": 5005,
    "message": "product not found",
    "localizedMsg": "product not found",
    "data": null
}