绑定用户设备 - bindDevice
功能介绍
绑定用户设备
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/backup/device
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 参数解释: 该字段存储的是 Access Token。 调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。 约束限制: 格式参考:Bearer+/access token} 取值范围: Access Token的获取请参考对应的开发手册 默认取值: 不涉及 |
X-User-Id | 是 | String | 参数解释: koodrive侧用户id,用于appId鉴权 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
X-Date | 是 | String | 参数解释: 签名时间,用于appId鉴权 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: yyyMMdd'T'HHmmss'Z',例:20251103T070140Z 默认取值: 不涉及 参数解释: 签名时间,用于appId鉴权 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: yyyMMdd'T'HHmmss'Z',例:20251103T070140Z 默认取值: 不涉及 |
X-traceid | 否 | String | 参数解释: 业务跟踪id(必须58位) 约束限制: 不涉及 取值范围: 长度为58位 默认值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
machineCode | 是 | String | 参数解释: 机器码 约束限制: ^[a-zA-Z0-9_]{1,64}$ 取值范围: 最大长度64 默认值: 不涉及 |
deviceName | 否 | String | 参数解释: 设备名 约束限制: ^[a-zA-Z0-9-_\s]{1,32}$ 取值范围: 最大长度32 默认值: 不涉及 |
deviceOS | 否 | String | 参数解释: 设备系统 约束限制: ^[a-zA-Z0-9_\s]{1,32}$ 取值范围: 最大长度32 默认值: 不涉及 |
请求示例
绑定用户设备请求示例
/koodrive/{{service}}/v1/backup/device
Authorization:Bearer+60f4ccc7b1********3dd9a68068
{
"machineCode": "20251217",
"deviceName": "Magic-v5",
"deviceOS": "android"
} 响应示例
状态码:200
绑定用户设备响应体
{
"data" : {
"deviceId" : "1842812272691451648",
"machineCode" : "20251217",
"deviceName" : "Magic-v5",
"deviceOS" : "android",
"createTime" : "2025-12-17T06:19:01.803Z"
},
"code" : 0,
"msg" : "success"
} 状态码
状态码 | 描述 |
|---|---|
200 | 绑定用户设备响应体 |

