ECJiaWiki:Api:comment/create

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 用户购买商品后,对商品进行评论

接口名称

 comment/create

Header请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
设备唯一ID device-udid String a46d663d675d4858ea7d0a21c2de06e9 设备的唯一编号 1.3.0
设备客户端类型 device-client String android,iphone,h5,weapp 设备类型的描述 1.3.0
产品编号 device-code String 6015 产品编号 1.3.0
API版本 api-version String 1.6 API接口版本号 1.3.0

举例如下

{
    "device-udid" : "a46d663d675d4858ea7d0a21c2de06e9",
    "device-client" : "weapp",
    "device-code " : "6015",
    "api-version" : "1.6",
}

Body请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
token请求凭证 token String 调用接口凭证 1.3.0
评论对象id object_id Int 评论对象id (商品id或文章id) 1.3.0 1.4.0
评论对象类型 object_type String 评论对象类型,默认为商品(goods)、文章(article) 1.3.0 1.4.0
评论用户名称 user_name String 评论用户名称,默认为当前用户 1.3.0 1.4.0
订单id order_id Int 只在对商品进行评论时需要 1.3.0 1.4.0
评论内容 content String 评论内容 1.3.0
评论等级 rank String 评论等级 (1-5,5是最好,1是最差) 1.3.0
rec_id rec_id Int 只在对商品进行评论时需要,多属性必传 1.4.0
评论图片 picture File 晒图(文件上传) 1.4.0
是否匿名 is_anonymous Int 是否匿名评论(1是,0不是) 1.4.0

举例如下

{
      "token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
      "rec_id" : 1,
      "content" : "很好",
      "rank" : 5,
      "picture" : "",
      "is_anonymous" : 1,
}

返回参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
返回状态码 status Json {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明) 1.3.0
返回信息 data Array 请求接口提供的返回信息 1.3.0

成功举例如下

{ 
      "data": [],
      "status": {
            "succeed": 1
      }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : 100,
            "error_desc" : "Invalid session",
      }
}


注:错误编码