用户服务
更新时间：2018-06-25 12:06:05
绑定push通道
定义描述
| path |
版本 |
描述 |
是否需要用户身份的鉴权 |
| /uc/bindPushChannel |
1.0.2 |
绑定push通道 |
是，客户端SDK需启用身份的鉴权 |
请求参数
| 参数 |
类型 |
必填 |
描述 |
| deviceId |
String |
是 |
push通道的deviceId |
| deviceType |
String |
是 |
设备类型：iOS或ANDROID，值由业务方和app协商 |
返回参数
| 参数 |
类型 |
描述 |
| code |
Integer |
IoT通用code |
| id |
String |
请求id |
示例
请求示例
{
"request": {
"iotToken": "109049c80bcde4c06b15f6f62e29a3ba",
"apiVer": "1.0.2"
},
"id": 1508212818676,
"params": {
"deviceId":"xxxx",
"deviceType":"iOS"
},
"version": "1.0"
}
正常返回示例
{
"code": 200,
"id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}
异常返回示例
{
"code":2062,
"id":"4fa207ca-fffd-48bb-94b8-e6f7ca6c99c3",
"localizedMsg":"请求错误",
"message":"identityId not exist"
}
解绑push通道
定义描述
| path |
版本 |
描述 |
是否需要用户身份的鉴权 |
| /uc/unbindPushChannel |
1.0.2 |
绑定push通道 |
是，客户端SDK需启用身份的鉴权 |
请求参数
| 参数 |
类型 |
必填 |
描述 |
| deviceId |
String |
是 |
push通道的deviceId |
返回参数
| 参数 |
类型 |
描述 |
| code |
Integer |
IoT通用返回code |
| id |
String |
请求id |
示例
请求示例
{
"request": {
"iotToken": "109049c80bcde4c06b15f6f62e29a3ba",
"apiVer": "1.0.2"
},
"id": 1508212818676,
"params": {
"deviceId":"xxxx"
},
"version": "1.0"
}
正常返回示例
{
"code": 200,
"id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}
异常返回示例
{
"code":2062,
"id":"4fa207ca-fffd-48bb-94b8-e6f7ca6c99c3",
"localizedMsg":"请求错误",
"message":"identityId not exist"
}
错误码
| 错误码 |
错误信息 |
来源 |
详细描述 |
| 200 |
success |
系统 |
成功 |
| 400 |
request error. |
系统 |
请求错误 |
| 401 |
request auth error. |
系统 |
请求认证错误 |
| 403 |
request forbidden. |
系统 |
请求被禁止 |
| 404 |
service not found. |
系统 |
服务未找到 |
| 429 |
too many requests. |
系统 |
太多请求 |
| 460 |
request parameter error. |
系统 |
请求参数错误 |
| 500 |
service error. |
系统 |
服务端错误 |
| 503 |
service not available. |
系统 |
服务不可用 |