接口说明
更新时间：2020-08-27
数据加密
| 方法 | API | 说明 |
|---|---|---|
| POST | /v1/tsm/device/{deviceId}/encrypt | 对数据进行加密和签名，签名算法为：SHA1RSA，加密算法为："RSA/ECB/PKCS1Padding" |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
| deviceId | String | 必须 | URL参数 | 设备唯一ID |
| data | String | 必须 | RequestBody参数 | 需要加密、签名的数据，以base64编码 |
| type | String | 可选 | RequestBody参数 | 数据编码类型，默认为base64 |
| cipherEncodeType | String | 可选 | RequestBody参数 | 密文数据编码类型，默认为hex，支持 hex |base64 |
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| data | String | 密文数据，以base64编码（包括签名数据） |
请求示例
POST /v1/tsm/device/de9b28dkjdf21rcf/encrypt HTTP/1.1
Host: hisk.baidubce.com
Authorization: {authorization}
Content-Type: application/json; charset=utf-8
x-bce-date: 2016-06-06T11:52:41Z
{
"data": "YmFpZHUK",
"type": "base64"
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
x-bce-request-id: 72492aee-1470-46d0-8a4d-0dab7b8e67b7
{
"data": "XYzsF...EMza"
}数据解密
| 方法 | API | 说明 |
|---|---|---|
| POST | /v1/tsm/device/{deviceId}/decrypt | 数据验证签名和解密，签名算法为：SHA1RSA，加密算法为："RSA/ECB/PKCS1Padding" |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
| deviceId | String | 必须 | URL参数 | 设备唯一ID |
| data | String | 必须 | RequestBody参数 | 消息明文数据，以base64编码 |
| type | String | 可选 | RequestBody参数 | 数据编码类型，默认为base64 |
| cipherEncodeType | String | 可选 | RequestBody参数 | 密文数据编码类型，默认为hex，支持 hex |base64 |
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| data | String | 解密后的数据，以base64编码 |
请求示例
POST /v1/tsm/device/de9b28dkjdf21rcf/decrypt HTTP/1.1
Host: tsm.iot.gz.bce-internal.baidu.com
Authorization: {authorization}
Content-Type: application/json; charset=utf-8
x-bce-date: 2016-06-06T11:52:41Z
{
"data": "wrFadf...asdfweAW"
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
x-bce-request-id: 72492aee-1470-46d0-8a4d-0dab7b8e67b7
{
"data": "EraF...adf"
}设备激活
| 方法 | API | 说明 |
|---|---|---|
| POST | /v1/tsm/device/{deviceId}/active | 设备激活，签名算法为：SHA1RSA，加密算法为："RSA/ECB/PKCS1Padding" |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
| deviceId | String | 必须 | URL参数 | 设备唯一ID |
| data | String | 必须 | RequestBody参数 | 激活数据，以base64编码。签名算法为：SHA1RSA，加密算法为："RSA/ECB/PKCS1Padding" |
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| data | String | 解密后的设备唯一ID |
请求示例
POST /v1/tsm/device/de9b28dkjdf21rcf/active HTTP/1.1
Host: tsm.iot.gz.bce-internal.baidu.com
Authorization: {authorization}
Content-Type: application/json; charset=utf-8
x-bce-date: 2016-06-06T11:52:41Z
{
"data": "werxFDs...weDSde="
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
x-bce-request-id: 72492aee-1470-46d0-8a4d-0dab7b8e67b7
{
"data": "de9b28dkjdf21rcf"
}设备认证
| 方法 | API | 说明 |
|---|---|---|
| POST | /v1/tsm/device/{deviceId}/auth | 设备认证 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
| deviceId | String | 必须 | URL参数 | 设备唯一ID |
| authCode | String | 必须 | RequestBody参数 | 设备认证数据 |
| extra | String | 非必须 | RequestBody参数 | 认证辅助数据，以base64编码 |
请求示例
POST /v1/tsm/device/de9b28dkjdf21rcf/auth HTTP/1.1
Host: tsm.iot.gz.bce-internal.baidu.com
Authorization: {authorization}
Content-Type: application/json; charset=utf-8
x-bce-date: 2016-06-06T11:52:41Z
{
"authCode": "0-0-1500954672-Yadfwezawq23asfdadf="
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
x-bce-request-id: 72492aee-1470-46d0-8a4d-0dab7b8e67b7