调用该接口提交一条新的意见反馈记录。

路径 /feedback/add
版本号 1.0.3
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权 是
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
mobileSystem String 是 Android 手机的系统。
appVersion String 是 Version 1.0 App的版本号。
type Int 是 1 问题类型。设备相关问题的取值为：1表示设备问题、2表示配网问题、3表示其他问题。手机相关问题的取值为：101表示反馈故障、102表示功能建议、103表示其他问题。
productKey String 否 a1U2****UZI 产品的Key，设备证书信息之一。创建产品时，生活物联网平台为该产品颁发的全局唯一标识。iotId为空时，该入参不允许为空。
content String 是 text 意见反馈的内容。
iotId String 否 aD12ef8Kk****EiNJJ001082 设备ID，生活物联网平台为设备颁发的ID，设备的唯一标识符。productKey为空时，该入参不允许为空。
mobileModel String 是 phone1 手机的型号。
contact String 是 1390000**** 联系方式。
topic String 是 text2 意见反馈的主题。
nickName String 否 XXX的设备 设备的昵称或别名。
ossObjectName String 否 value 与意见反馈关联日志的OSS Object 名称。
deviceName String 否 light001 设备的名称，设备证书信息之一。在注册设备时，自定义的或系统生成的设备名称，具备产品维度内的唯一性。
mobileLogFileId String 否 value2 意见反馈关联的手机日志的文件ID（0115后支持）。
deviceLogFileId String 否 value3 与意见反馈关联的设备日志文件ID。
deviceErrorIndexId String 否 value4 与意见反馈关联的设备错误日志批次ID。
appErrorIndexId String 否 value5 意见反馈关联的APP错误日志批次ID。
errors List 否 0 设备错误码列表。包含以下参数：time：错误产生的时间；sign：加签字串；signSecretType：加签密钥类型，默认0。0（表示deviceSecret）；1（表示productSecret）。
error Struct 是 error 设备具体错误信息
codeVer String 是 value6 设备端错误码版本
state Int 是 0 设备当前状态
code Int 是 200 错误码
errMsg String 否 text3 错误信息
time Long 否 1 错误产生的时间戳。
sign String 是 value7 加签字串。
signSecretType Int 是 0 加签密钥类型，默认0。0（表示deviceSecret）；1（表示productSecret）。

返回数据

名称 类型 示例值 描述
code Int

接口返回码，200表示成功。
message String

调用失败时，返回的出错信息。
localizedMsg String

本地语言的错误消息。
data Long

新增意见反馈记录的ID。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.3",
		"iotToken": "token"
	},
	"params":{
		"mobileSystem": "Android",
		"appVersion": "Version 1.0",
		"type":1,
		"productKey": "a1U2****UZI",
		"content": "text",
		"iotId": "aD12ef8Kk****EiNJJ001082",
		"mobileModel": "phone1",
		"contact": "1390000****",
		"topic": "text2",
		"nickName": "XXX的设备",
		"ossObjectName": "value",
		"deviceName": "light001",
		"mobileLogFileId": "value2",
		"deviceLogFileId": "value3",
		"deviceErrorIndexId": "value4",
		"appErrorIndexId": "value5",
		"errors":0
	}
}

正常返回示例

JSON格式 

{
    "code":200,
    "data":3,
    "message":"success",
    "localizedMsg":null
}

异常返回示例

JSON格式 

{
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "请求被禁止",
    "data": null
}