ECJiaWiki:Api:store/comments

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取店铺评论

接口名称

 store/comments

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
店铺id store_id Int 1.4.0
评论类型 comment_type String 评论类型,默认为全部(all),好评(good),中评(general),差评(low),晒图(picture) 1.4.0
分页信息 pagination Array 分页信息 1.4.0
每页显示条数 count Int 每页显示条数 1.4.0
当前页数 page Int 当前页数 1.4.0

举例如下

{
    "store_id" : 1,
    "comment_type" : 'all',
    "pagination" : {
    	"count" : 10,
    	"page" : 1,
    }
    
}

返回参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
返回状态码 status Json {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明) 1.4.0
返回信息 data Array 请求接口提供的返回信息 1.4.0
好评率 comment_percent int 90 好评率(默认没有评价为100),客户端拼接“%” 1.4.0
评论数量 comment_number Array 每个评论类型对应的数量 1.4.0
  -全部评论数量 all int 200 1.4.0
  -好评数量 good int 180 1.4.0
  -中评数量 general int 18 1.4.0
  -差评数量 low int 2 1.4.0
  -图片评论数量 picture int 50 1.4.0
列表字典 list Array 1.4.0
  -评论id id Int 评论id 1.4.0
  -评论用户名称 author String "匿名用户" 评论用户名称 1.4.0
  -评论内容 content String 评论内容 1.4.0
  -评论星级 rank Int 评论星级 1.4.0
  -商品属性 goods_attr String 白色,xl 1.4.0
  -评论图片 picture Array 评论图片 1.4.0
  -评论时间 add_time String "2010-01-13" 评论时间 1.4.0
  -管理员回复内容 reply_content String 管理员回复内容 1.4.0
  -管理员名称 reply_username String 管理员名称 1.4.0
  -管理员回复时间 reply_add_time String "2010-01-13 15:07:58" 管理员回复时间 1.4.0
分页信息 paginated Array 分页信息 1.4.0
  -总条数 total Int 总条数 1.4.0
  -当前返回数组的总条数 count Int 当前返回数组的总条数 1.4.0
  -是否有下一页 more Int 1:有下一页,0:没有下一页 是否有下一页 1.4.0

成功举例如下

{ 
      "data": {
            "comment_percent" : 90,
            "comment_number" : {
                "all" : 200,
                "good" : 180,
                "general" : 18,
                "low" : 2,
                "picture": 80,
            },
            "list":[{
               "id" : "201",
               "author" : "匿名用户",
               "content" : "东西收到了,质量很好,包装很结实,感谢卖家热心的解答",
               "rank" : "5",
               "goods_attr": "白色,xl",
               "picture": [{
                   "https://cityo2o.ecjia.com/content/uploads/images/201610/goods_img/1075_P_1477612303654.jpg",
                   "https://cityo2o.ecjia.com/content/uploads/images/201610/goods_img/1075_P_1477612303654.jpg"
                }],
               "add_time" : "2010-01-13 15:07:58",
               "reply_content" : "需要手动修改CSS了<br />\r\n",
               "reply_username" : "客服xxx",
               "reply_add_time" : "2010-01-19 14:26:37",
            }],
      },
      "status": {
            "succeed": 1
      },
      "paginated": {
            "total" : 37,
            "count" : 10,
            "more" : 1
      }
}

失败举例如下

注:错误编码