调用该接口获取密钥。

路径 /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
}