意见反馈(Feedback)是智能生活平台提供的连接用户、商家和开发者的一种通道。通过意见反馈,开发者和商家可以及时和用户保持沟通,提升用户满意度。
提交意见反馈
定义描述
path | 版本 | 描述 | 是否需要登录 |
---|---|---|---|
/feedback/add | 1.0.1 | 提交一条意见反馈 | 是 |
请求参数
参数名 | 类型 | 是否必须 | 描述 |
---|---|---|---|
mobileSystem | String | 是 | 手机系统 |
appVersion | String | 是 | App版本号 |
type | Int | 是 | 枚举值
|
productKey | String | 是 | 产品key |
content | String | 是 | 意见反馈内容 |
iotId | String | 是 | 设备ID |
mobileModel | String | 是 | 手机型号 |
contact | String | 是 | 联系方式 |
topic | String | 是 | 意见反馈主题 |
devicename | String | 是 | 设备名称 |
返回参数
参数 | 类型 | 必有 | 描述 |
---|---|---|---|
data | Long | 是 | 意见反馈记录ID |
示例
- 请求示例
{ "id": "1509086454180", "version": "1.0", "request": { "apiVer": "1.0.1", "iotToken": "token" }, "params": { "appVersion": "10.0.0", "type": 1, "productKey": "a1xxxxxNb", "content": "重试多次配网失败", "mobileModel": "iPhoneX", "contact": "1390000****", "mobileSystem": "ios", "appVersion": "1.1", "iotId": "fy2Z1oZFxxxxxxxx01edf00", "topic": "设备无法配网", "devicename": "手环" } }
- 正常返回示例
{ "code": 200, "data": 3, "message": "success", "localizedMsg": null, }
继续意见反馈
定义描述
path | 版本 | 描述 | 是否需要登录 |
---|---|---|---|
/feedback/reply/add | 1.0.1 | 在已有的反馈意见上,累加新的意见反馈 | 是 |
请求参数
参数名 | 类型 | 是否必须 | 描述 |
---|---|---|---|
type | Integer | 是 | 用户为1,运营为2 |
topicid | Long | 是 | 反馈意见ID |
content | String | 是 | 回复内容 |
mobileSystem | String | 是 | 手机型号 |
mobileModel | String | 是 | 手机系统 |
appVersion | String | 是 | app版本 |
返回参数
参数 | 类型 | 必有 | 描述 |
---|---|---|---|
data | Long | 是 | 继续意见反馈记录ID |
示例
- 请求示例
{ "id": "1509086454180", "version": "1.0", "request": { "apiVer": "1.0.1", "iotToken": "token" }, "params": { "type": 1, "content": "家里用的wifi网络配网", "mobileModel": "iPhoneX", "mobileSystem": "ios", "appVersion": "1.1", "topicid": 3 } }
- 正常返回示例
{ "code": 200, "data": 8, "message": "success", "localizedMsg": null, }
判断是否显示小红点
定义描述
path | 版本 | 描述 | 是否需要用户身份的鉴权 |
/feedback/redpoint/get | 1.0.1 | 判断是否在意见反馈菜单上显示小红点,小红点可以醒目提示用户该菜单有内容更新 | 是,客户端SDK需启用身份的鉴权,进行身份认证 |
请求参数
无
返回参数
参数 | 类型 | 必有 | 描述 |
data | Boolean | 是 | 是否需要在菜单上显示小红点:true需要显示;false不需要显示 |
示例
- 请求示例
{ "id": "1509086454180", "version": "1.0", "request": { "apiVer": "1.0.1", "iotToken": "token" }, "params": { } }
- 正常返回示例
{ "code": 200, "data": true, "message": "success", "localizedMsg": null, }
查询当前登录用户的意见反馈列表
定义描述
path | 版本 | 描述 | 是否需要用户身份的鉴权 |
---|---|---|---|
/feedbacklist/querybyuid | 1.0.1 | 根据用户信息查询意见反馈列表 | 是,客户端SDK需启用身份的鉴权,进行身份认证 |
请求参数
参数类型 | 必填 | 描述 | |
---|---|---|---|
pageSize | Integer | 是 | 页大小,单页的记录数量上限是200 |
pageNo | Integer | 是 | 当前页号,从1开始 |
返回参数
参数 | 类型 | 必有 | 描述 |
---|---|---|---|
data | json | 是 | 意见反馈的内容 |
data结构中详细字段说明如下:
mobileSystem | String | 手机系统 | |
---|---|---|---|
appVersion | String | app版本号 | |
type | Int | 枚举值
|
|
productKey | String | 产品key | |
content | String | 意见反馈内容 | |
iotId | String | 设备ID | |
mobileModel | String | 手机型号 | |
contact | String | 联系方式 | |
topic | String | 意见反馈主题 | |
devicename | String | 设备名称 | |
gmtModified | Date | 记录最近修改时间 | |
gmtCreate | Date | 记录创建时间 | |
productKey | String | 产品key | |
id | Long | 意见反馈记录ID | |
devicename | String | 设备名称 | |
replyStatus | Int | 回复状态,0-未读;1-已读 |
示例
- 请求示例
{ "id": "1509086454180", "version": "1.0", "request": { "apiVer": "1.0.1", "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, "feedbackStatus": 0 } ], "pageSize": 20, "pageId": null, }, "message": "success", "localizedMsg": null, }
根据意见反馈ID查询意见反馈信息
定义描述
path | 版本 | 描述 | 是否需要用户身份的鉴权 |
---|---|---|---|
/feedback/getbytopicId | 1.0.1 | 根据意见反馈ID查询意见反馈信息 | 是 |
请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
feedbackTopicId | Long | 是 | 意见反馈ID |
返回参数
参数 | 类型 | 必有 | 描述 |
---|---|---|---|
data | json | 是 | 意见反馈的内容 |
data结构中详细字段说明如下
mobileSystem | String | 手机系统 |
---|---|---|
appVersion | String | app版本号 |
type | Int | 枚举值
|
productKey | String | 产品key |
content | String | 意见反馈内容 |
iotId | String | 设备ID |
mobileModel | String | 手机型号 |
contact | String | 联系方式 |
topic | String | 意见反馈主题 |
devicename | String | 设备名称 |
gmtModified | Date | 记录最近修改时间 |
gmtCreate | Date | 记录创建时间 |
productKey | String | 产品key |
id | Long | 意见反馈记录ID,系统生成 |
devicename | String | 设备名称 |
replyStatus | Int | 回复状态,0-未读;1-已读 |
feedBackReplyList | List | 意见反馈回复以及再次反馈记录列表 |
FeedbackReplyList中的字段说明如下
id | Long | 回复以及再次反馈记录ID |
---|---|---|
appVersion | String | app版本号 |
type | Int | 2-回复;1-继续反馈 |
content | String | 回复内容或者再次反馈内容 |
gmtCreate | Date | 回复或者再次反馈的时间 |
topicid | Long | 意见反馈记录ID |
示例
- 请求示例
{ "id": "1509086454180", "version": "1.0", "request": { "apiVer": "1.0.1", "iotToken": "token" }, "params": { "feedbackTopicId": 10 } }
- 正常返回示例
{ "code": 200, "data": { "gmtModified": 1540460427000, "appVersion": "V1.2.0", "gmtLastFeedback": 1539683646000, "type": 103, "productKey": "", "content": "其他", "uid": "5021op82c076xxxxdd0e1788f5424b5384", "gmtLastReply": 1540460402000, "mobileModel": "M3X", "contact": "1390000****", "tenantNickName": "iot开发管理者", "id": 10, "userNickName": "180xxxx6420", "feedbackStatus": 0, "mobileSystem": "Android 6.0.1", "isolationId": "a103cxxxxTrF8", "gmtCreate": 1539683646000, "tags": "", "lastFeedback": "其他", "iotId": "", "lastReply": "<script>alert(1);</script>", "tenantId": "D99AEB09xxxxF008B2DCE1E313", "replyStatus": 0, "topic": "其他反馈", "devicename": "测试灯", "feedBackReplyList": [ { "uid": "158461194370****", "topicid": 10, "gmtModified": 1540xxxx1000, "id": 446, "type": 2, "gmtCreate": 1540xxxx1000, "content": "<script>alert(1);</script>" }, { "uid": "1584xxxx708270", "topicid": 10, "gmtModified": 15404xxxx1000, "id": 445, "type": 2, "gmtCreate": 15404xxxx1000, "content": "春节将近", } ] }, "message": "success", "localizedMsg": null, }
批量更新反馈回复记录状态为已读
定义描述
path | 版本 | 描述 | 是否需要用户身份的鉴权 |
---|---|---|---|
/feedback/reply/status/readable/update | 1.0.1 | 当用户打开某一条意见反馈时,调用该接口通知云端将所有回复置成已读状态 | 是,客户端SDK需启用身份的鉴权,进行身份认证 |
请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
feedbackTopicId | Long | 是 | 意见反馈记录ID |
返回参数
参数 | 类型 | 必有 | 描述 |
---|---|---|---|
data | Boolean | 是 | 状态更新是否成功,true为成功;false为失败 |
示例
- 请求示例
{ "id": "1509086454180", "version": "1.0", "request": { "apiVer": "1.0.0", "iotToken": "token" }, "params": { "feedbackTopicId": 10 } }
- 正常返回示例
{ "code": 200, "data": true, "message": "success", "localizedMsg": null, }