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

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

请求参数

名称 类型 是否必选 示例值 描述
mobileSystem String 手机的系统。
appVersion String APP的版本号。
type Int 设备相关枚举值:1(表示设备问题);2(表示配网问题);3(表示其他问题)。手机相关枚举值:101(表示反馈故障);102(表示功能建议);103(表示其他问题)。
productKey String 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。
content String 意见反馈的内容。
iotId String 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
mobileModel String 手机的型号。
contact String 联系方式。
topic String 意见反馈的主题。
nickName String 设备的昵称或别名。
ossObjectName String 与意见反馈关联日志的OSS Object 名称。
deviceName String 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。
mobileLogFileId String 意见反馈关联的手机日志的文件ID(0115后支持)
deviceLogFileId String 与意见反馈关联的设备日志文件ID。
deviceErrorIndexId String 与意见反馈关联的设备错误日志批次ID。
appErrorIndexId String 意见反馈关联的APP错误日志批次ID
errors List 设备错误码列表。包含以下参数:time(错误产生的时间)、sign(加签字串)、signSecretType(加签密钥类型,默认0。0(表示deviceSecret);1(表示productSecret))。

返回数据

名称 类型 示例值 描述
code Int

接口返回码,200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误消息。

data Long

新增意见反馈记录的ID。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "null",
		"iotToken": "token"
	},
	"params":{
		"mobileSystem": "value0",
		"appVersion": "value1",
		"type": "value2",
		"productKey": "value3",
		"content": "value4",
		"iotId": "value5",
		"mobileModel": "value6",
		"contact": "value7",
		"topic": "value8",
		"nickName": "value9",
		"ossObjectName": "value10",
		"deviceName": "value11",
		"mobileLogFileId": "value12",
		"deviceLogFileId": "value13",
		"deviceErrorIndexId": "value14",
		"appErrorIndexId": "value15",
		"errors": "value16"
	}
}

正常返回示例

JSON 格式

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

异常返回示例

JSON 格式

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