IoT视频云 > API 文档 > 设备密钥 >新增密钥

新增密钥

最近更新时间: 2019-03-22 15:35:52

描述

该接口用于新增设备的密钥，每个设备最多有两对密钥。

请求

请求语法

POST /v1/apps/<appid>/devices/<encodeDeviceName>/keys HTTP/1.1
Host: linking.qiniuapi.com
Content-Type: application/json
Authorization: <QiniuToken>

请求参数

参数名称	必填	字段类型	说明
appid	是	string	设备所属应用的appid，设备名称只能由 4-200 位英文字母和数字组成
encodeDeviceName	是	string	设备名称进行URL安全的Base64编码后得到的字符串

请求头
该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅公共请求头。
请求元素
该请求操作的请求体为空。

响应

响应头
该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头

响应元素

{
  "device": "<deviceName>",
  "keys": [
    {
      "accessKey": "<deviceAccessKey>",
      "secretKey": "<deviceSecretKey>",
      "state": "<state>"
    },
    {
      "accessKey": "<deviceAccessKey>",
      "secretKey": "<deviceSecretKey>",
      "state": "<state>"
    }
  ]
}

参数名称	说明
device	设备名称
keys	设备密钥对，初始时只有一对密钥
accessKey	设备端的 accessKey
secretKey	设备端的 secretKey
state	密钥对状态，1表示被禁用,0表示已启用

示例

请求示例

POST /v1/apps/test/devices/dGVzdGRldmljZTE=/keys HTTP/1.1

Host: linking.qiniuapi.com
Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=
Content-Type: application/json

响应示例

HTTP/1.1 200 OK
Access-Control-Allow-Origi: *
Connection: keep-alive
Content-Length: xxx
Content-Type: application/json
Date: Wed, 26 Sep 2018 11:42:10 GMT
Server: nginx/1.8.0
Vary: Accept-Encoding
X-Reqid: 6SAAABDWHM1o8FcV
X-Whom: cs1

200 {
  "device": "test123",
  "keys": [ 
    {
      "accessKey": "Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcxxxxx",
      "secretKey": "eNFrLXKG3R8TJ-DJAxxxxxLwuEfQnw8krrDuZzoy",
      "state": 1 
    },
    {
      "accessKey": "Ves3WTXC8XnEadfv_vacEQQz-9jrJZxNExcxxxxx",
      "secretKey": "eNFrLXKG3R8TsfghfxxxxxLwuEfQnw8krrDuZzoy",
      "state": 0
    }
  ]
}

以上内容是否对您有帮助？