调用该接口获取秘钥。

路径 /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）。

返回数据

名称 类型 示例值 描述
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
}