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

提交意见反馈

定义描述

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

请求参数

参数名 类型 是否必须 描述
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 设备名称

返回参数

参数 类型 必有 描述
data Long 意见反馈记录ID

示例

  • 请求示例
    {
        "id": "1509086454180",
        "version": "1.0",
        "request": {
            "apiVer": "1.0.1",
            "iotToken": "token"
        },
        "params": {
                 "appVersion": "10.0.0",
                 "type": 1,
                 "productKey": "a1OwEjYFJNb",
                 "content": "重试多次配网失败",
                 "mobileModel": "iPhoneX",
                 "contact": "15066666666",
                 "mobileSystem": "ios",
                 "appVersion": "1.1",
                 "iotId": "fy2Z1oZFWZQVii6kkFVM00101edf00",
                 "topic": "设备无法配网",
                 "devicename": "手环"
        }
    }
    					
  • 正常返回示例
    {
      "code": 200,
      "data": 3,
      "message": "success",
      "localizedMsg": null,
      "class": "com.aliyun.iotx.common.base.service.IoTxResult"
    					

继续意见反馈

定义描述

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,
      "class": "com.aliyun.iotx.common.base.service.IoTxResult"
    }
    					

判断是否显示小红点

定义描述

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,
      "class": "com.aliyun.iotx.common.base.service.IoTxResult"
    }
    					

根据用户信息查询意见反馈列表

定义描述

path 版本 描述 是否需要用户身份的鉴权
/feedbacklist/querybyuid 1.0.1 根据用户信息查询意见反馈列表 是,客户端SDK需启用身份的鉴权,进行身份认证

请求参数

参数 类型 必填 描述
pageSize String 页大小,单页的记录数量上限为 200​
pageNo String 当前页号,从 1 开始

返回参数

参数 类型 必有 描述
data FeedbackTopicDTO 意见反馈主题DTO,参考上面DTO描述
需要用到的字段说明如下:
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 设备名称
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,
            "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查询意见反馈信息

定义描述

path 版本 描述 是否需要用户身份的鉴权
/feedback/getbytopicId 1.0.1 根据意见反馈ID查询意见反馈信息

请求参数

参数 类型 必填 描述
feedbackTopicId String 意见反馈Id

返回参数

参数 类型 必有 描述
data FeedbackDTO 意见反馈主题DTO,参考上面DTO描述
FeedbackDTO需要用到的字段说明如下:
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 设备名称
gmtModified Date 记录最近修改时间
gmtCreate Date 记录创建时间
productKey String 产品key
id Long 意见反馈记录ID
devicename String 设备名称
replyStatus Int 回复状态,0未读,1已读
feedBackReplyList List 意见反馈回复以及再次反馈记录列表
FeedbackReplyDTO需要用到的字段说明如下
id Long 回复以及再次反馈记录ID
appVersion String app版本号
type Int 2 回复;1 继续反馈;
content String 回复内容或者再次反馈内容
gmtCreate Date 回复或者再次反馈的时间
需要用到的字段说明如下

示例

  • 请求示例
    {
        "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": "5021op82c076b73ffcad94dd0e1788f5424b5384",
        "gmtLastReply": 1540460402000,
        "mobileModel": "M3X",
        "contact": "18373637272",
        "tenantNickName": "iot开发管理者",
        "id": 10,
        "userNickName": "18042006420",
        "class": "com.aliyun.iotx.ilop.business.facade.dto.FeedBackDTO",
        "feedbackStatus": 0,
        "mobileSystem": "Android 6.0.1",
        "isolationId": "a103cg3XCLYnTrF8",
        "gmtCreate": 1539683646000,
        "tags": "",
        "lastFeedback": "其他",
        "iotId": "",
        "lastReply": "<script>alert(1);</script>",
        "tenantId": "D99AEB09DCDB4B25ACF008B2DCE1E313",
        "replyStatus": 0,
        "topic": "其他反馈",
        "devicename": "测试灯",
        "feedBackReplyList": [
          {
            "uid": "1584611943708270",
            "topicid": 10,
            "gmtModified": 1540460401000,
            "id": 446,
            "type": 2,
            "gmtCreate": 1540460401000,
            "class": "com.aliyun.iotx.ilop.business.facade.dto.FeedbackReplyDTO",
            "content": "<script>alert(1);</script>"
          },
          {
            "uid": "1584611943708270",
            "topicid": 10,
            "gmtModified": 1540460271000,
            "id": 445,
            "type": 2,
            "gmtCreate": 1540460271000,
            "class": "com.aliyun.iotx.ilop.business.facade.dto.FeedbackReplyDTO",
            "content": "春节将近"
          }
        ]
      },
      "message": "success",
      "localizedMsg": null,
      "class": "com.aliyun.iotx.common.base.service.IoTxResult"
    }
    					

批量更新反馈回复记录状态为已读

定义描述

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,
      "class": "com.aliyun.iotx.common.base.service.IoTxResult"
    }