意见反馈
更新时间:2018-11-20 17:27:28
APP接口文档
1、判断是否显示小红点
API名称:isFeedBackRedPoint
HTTP Method:POST
协议:HTTPS
定义描述
path
|
版本
|
描述
|
是否需要用户身份的鉴权
|
/feedback/redpoint/get
|
1.0.0
|
判断是否显示小红点
|
是,客户端SDK需启用身份的鉴权
|
请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
返回参数
参数
|
类型
|
必有
|
描述
|
data
|
Boolean
|
是
|
是否需要显示红点
true:需要显示
false:不需要显示
|
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request": {
"apiVer": "1.0.0",
"iotToken": "token"
},
"params": {
}
}
正常返回示例
{
"code": 200,
"data": true,
"message": "success",
"localizedMsg": null,
"class": "com.aliyun.iotx.common.base.service.IoTxResult"
}
2、根据用户信息查询意见反馈列表
API名称:queryFeedbackListByUid
HTTP Method:POST
协议:HTTPS
定义描述
path | 版本 | 描述 | 是否需要用户身份的鉴权 |
---|---|---|---|
Path:/feedbacklist/querybyuid | 1.0.0 | 根据用户信息查询意见反馈列表 | 是,客户端SDK需启用身份的鉴权 |
请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
返回参数
参数 | 类型 | 必有 | 描述 |
---|---|---|---|
data | FeedbackTopicDTO | 是 | 意见反馈主题DTO,参考上面DTO描述 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request": {
"apiVer": "1.0.0",
"iotToken": "token"
},
"params": {
"pageNo": 1,
"pageSize": 10,
}
}
正常返回示例
返回值示例:
{
"code": 200,
"data": {
"total": 1,
"data": [
{
"mobileSystem": "安卓",
"appVersion": "1.0",
"gmtModified": 1539423792000,
"gmtLastFeedback": 1539423676000,
"isolationId": "2",
"type": 2,
"productKey": "2",
"gmtCreate": 1539423792000,
"content": "2",
"tags": "2",
"uid": "2",
"lastFeedback": "2",
"iotId": "2",
"gmtLastReply": 1539423676000,
"mobileModel": "华为",
"lastReply": "2",
"contact": "138",
"tenantId": "2",
"replyStatus": 0,
"topic": "2",
"devicename": "2",
"id": 3,
"class": "com.aliyun.iotx.ilop.business.facade.dto.FeedbackTopicDTO",
"feedbackStatus": 0
}
],
"pageSize": 20,
"pageId": null,
"class": "com.aliyun.iotx.lego.facade.result.PaginationResult"
},
"message": "success",
"localizedMsg": null,
"class": "com.aliyun.iotx.common.base.service.IoTxResult"
}
请求参数
参数名 | 类型 | 是否必须 | 默认值 | 示例值 | 描述 |
---|---|---|---|---|---|
用户id | |||||
---|---|---|---|---|---|
pageSize | String | 是 | 20 | 每页条数 | |
pageNo | String | 是 | 1 | 页码 |
3、根据意见反馈ID查询意见反馈信息
API名称:getFeedBackByFeedbackTopicId
版本号:1.0.0
Path:/feedback/getbytopicId
HTTP Method:POST
协议:HTTP
域名:1b0a47fc118d4c3e8436dcaad5193d26-cn-shanghai.alicloudapi.com
复制
API描述:根据意见反馈ID查询意见反馈信息
请求参数
参数名 | 类型 | 是否必须 | 默认值 | 示例值 | 描述 |
---|---|---|---|---|---|
feedbackTopicId | String | 是 | 意见反馈Id | ||
---|---|---|---|---|---|
返回值描述:
返回值示例:
{
"code": 200,
"data": {
"appVersion": "1.0.0",
"gmtModified": 1539423154000,
"gmtLastFeedback": 1539422738000,
"type": 1,
"productKey": "test",
"content": "shssss",
"uid": "chl",
"gmtLastReply": 1539422738000,
"mobileModel": "ios",
"contact": "137",
"id": 1,
"feedbackStatus": 0,
"mobileSystem": "ios",
"isolationId": "test",
"gmtCreate": 1539422738000,
"tags": "",
"iotId": "test",
"lastFeedback": "test",
"lastReply": "test",
"tenantId": "test",
"topic": "1",
"replyStatus": 1,
"devicename": "test",
"feedBackReplyList": [
{
"uid": "208880",
"topicid": 1,
"gmtModified": 1539314402000,
"id": 7,
"type": 1,
"gmtCreate": 1539314402000,
"class": "com.aliyun.iotx.ilop.business.facade.dto.FeedbackReplyDTO",
"content": "*********************************************test*************"
},
{
"uid": "208880",
"topicid": 1,
"gmtModified": 1539258042000,
"id": 6,
"type": 1,
"gmtCreate": 1539258042000,
"class": "com.aliyun.iotx.ilop.business.facade.dto.FeedbackReplyDTO",
"content": "*********************************************test*************"
}
]
},
"message": "success",
"localizedMsg": null,
"class": "com.aliyun.iotx.common.base.service.IoTxResult"
}
4、批量更新反馈回复记录状态为已读
API名称:updateFeedBackReplyStatusReadable
版本号:1.0.0
Path:/feedback/reply/status/readable/update
HTTP Method:POST
协议:HTTP
域名:1b0a47fc118d4c3e8436dcaad5193d26-cn-shanghai.alicloudapi.com
复制
API描述:批量更新反馈回复记录状态为已读
请求参数
参数名 | 类型 | 是否必须 | 默认值 | 示例值 | 描述 |
---|---|---|---|---|---|
feedbackTopicId | String | 是 | 意见反馈主题ID | ||
---|---|---|---|---|---|
返回值示例:
{
"code": 200,
"data": true,
"message": "success",
"localizedMsg": null,
"class": "com.aliyun.iotx.common.base.service.IoTxResult"
}
5、继续意见反馈
API名称:addFeedBackReply
版本号:1.0.0
Path:/feedback/reply/add
HTTP Method:POST
协议:HTTP
域名:1b0a47fc118d4c3e8436dcaad5193d26-cn-shanghai.alicloudapi.com
复制
API描述:继续意见反馈
请求参数
参数名 | 类型 | 是否必须 | 默认值 | 示例值 | 描述 |
---|---|---|---|---|---|
type | Integer | 是 | | | 运营为1,用户为2 |
topicid | Long | 是 | | | 反馈意见ID |
content | String | 是 | | | 回复内容 |
mobileSystem | String | 是 | 手机型号 | ||
mobileModel | String | 是 | 手机系统 | ||
appVersion | String | 是 | app版本 |
返回值示例:
{
"code": 200,
"data": 8,
"message": "success",
"localizedMsg": null,
"class": "com.aliyun.iotx.common.base.service.IoTxResult"
}
6、提交一条意见反馈
API名称:addFeedBack
版本号:1.0.0
Path:/feedback/add
HTTP Method:POST
协议:HTTPS
域名:1b0a47fc118d4c3e8436dcaad5193d26-cn-shanghai.alicloudapi.com
复制
API描述:提交一条意见反馈
请求参数
请求参数
参数名 | 类型 | 是否必须 | 默认值 | 示例值 | 描述 |
---|---|---|---|---|---|
mobileSystem
|
String
|
是
|
手机系统
|
||
appVersion
|
String
|
是
|
app版本号
|
||
type
|
Int
|
是
|
枚举值:D_DEVICE(1, "设备问题"), D_AWSS(2, "配网问题"), D_OTHER(3, "其他问题"), A_BUG(101, "故障反馈"), A_FUNCTION(102, "功能建议"), A_OTHER(103, "其他问题");
|
||
productKey
|
String
|
是
|
产品key
|
||
content
|
String
|
是
|
意见反馈内容
|
||
iotId
|
String
|
是
|
设备Id
|
||
mobileModel
|
String
|
是
|
手机型号
|
||
contact
|
String
|
是
|
联系方式
|
||
topic
|
String
|
是
|
意见反馈主题
|
||
devicename
|
String
|
是
|
设备名称
|
返回值示例:
{
"code": 200,
"data": 3,
"message": "success",
"localizedMsg": null,
"class": "com.aliyun.iotx.common.base.service.IoTxResult"
}