意见反馈

更新时间:2019-06-17 21:06:08

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

提交一条意见反馈

定义描述

path 版本 描述 是否需要登陆
/feedback/add 1.0.1 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 设备名称

返回参数

参数 类型 必有 描述
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 API描述:继续意见反馈

请求参数

参数名 类型 是否必须 默认值 示例值 描述
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 版本 描述 是否需要用户身份的鉴权
Path:/feedbacklist/querybyuid 1.0.1 根据用户信息查询意见反馈列表 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
pageSize String 每页条数​
pageNo String 页码

返回参数

参数 类型 必有 描述
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 版本 描述 是否需要用户身份的鉴权
Path:/feedback/getbytopicId 1.0.1 根据意见反馈ID查询意见反馈信息

,包括反馈的回复,以及再次反馈的信息 | 是,客户端SDK需启用身份的鉴权 |

请求参数

参数 类型 必填 描述
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 版本 描述 是否需要用户身份的鉴权
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"
}

错误码

请参考公共错误码

results matching ""

    No results matching ""