= 用户反馈接口数据格式定义 =

== 提交反馈信息接口 ==

接口地址：
{{{
  http://www.imofan.com/interface/feedback/submit/${app_key}
}}}

接口参数以POST方式提交，其参数定义如下：
{{{
* type，反馈类型，必填，取值为：1 正面、-1 负面
* content，用户提交的反馈信息，必填，限制上限为500个全角文字
}}}

以下运行环境参数定义与[wiki:DataDefinition 数据指标及定义]中的同名参数一致
{{{
* dev_id
* device_id
* mac_addr
* sdk_ver
* app_ver
* os
* os_ver
* carrier
* access
* resolution
* model
* jailbroken，仅iOS设备需要提交该参数
* timezone
* language
}}}

响应JSON：
{{{
{
  "status":  1,          //状态取值为：1 提交成功、-1 提交失败\
  "message": "系统消息",  //当提交失败时的系统反馈信息\
  "id":      251         //提交成功后返回的反馈数据id，用作后续查询客户回复状态等
}
}}}

== 获取所有反馈数据接口 ==

接口地址：
{{{
  http://www.imofan.com/interface/feedback/all/${app_key}
}}}

接口参数以GET方式提交，其参数定义如下：
{{{
//以下参数与[wiki:DataDefinition 数据指标及定义]中的同名参数一致
* dev_id
* device_id
* mac_addr
}}}

响应JSON：
{{{
{
  "feedbacks": [
    {
      "type":          1,             //反馈类型，取值为：1 正面、-1 负面
      "content":       "反馈信息",
      "feedback_time": 131243214514,  //反馈提交时间，1970-1-1开始毫秒数
      "reply":         "回复信息",        
      "reply_time":    214124523523   //回复时间，1970-1-1开始毫秒数，为0表示还未回复
    },
    {
      ...
    },
    ...
  ]
}
}}}

== 检查某一条反馈信息回复状态的数据接口 ==

接口地址：
{{{
  http://www.imofan.com/interface/feedback/check/${app_key}
}}}

接口参数以GET方式提交，其参数定义如下：
{{{
* feedback_id，调用submit接口时返回的id信息
//以下参数与[wiki:DataDefinition 数据指标及定义]中的同名参数一致
* dev_id
* device_id
* mac_addr
}}}

响应JSON：
{{{
{
  "type":          1,             //反馈类型，取值为：1 正面、-1 负面
  "content":       "反馈信息",
  "feedback_time": 131243214514,  //反馈提交时间，1970-1-1开始毫秒数
  "reply":         "回复信息",        
  "reply_time":    214124523523   //回复时间，1970-1-1开始毫秒数，为0表示还未回复
}
}}}