意见反馈(Feedback)是智能生活平台提供的连接用户、商家和开发者的一种通道。通过意见反馈,开发者和商家可以及时和用户保持沟通,提升用户满意度。

提交意见反馈

定义描述

path 版本 描述 是否需要登录
/feedback/add 1.0.1 提交一条意见反馈

请求参数

参数名 类型 是否必须 描述
mobileSystem String 手机系统
appVersion String App版本号
type Int 枚举值
  • 1:设备问题
  • 2:配网问题
  • 3:其他问题
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 枚举值
  • 1:设备问题
  • 2:配网问题
  • 3:其他问题
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 枚举值
  • 1:设备问题
  • 2:配网问题
  • 3:其他问题
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,
    }