ECJiaWiki:Api:goods/comments

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取商品评论

接口名称

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

举例如下

{
    "goods_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.3.0
返回信息 data Array 请求接口提供的返回信息 1.3.0
好评率 comment_percent String "90%" 好评率(默认没有评价为100%) 1.4.0
评论数量 comment_totals 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.3.0
└评论用户邮箱 email String "123456@mobile.com" 评论用户邮箱 1.3.0 1.4.0
└评论用户名称 author String "匿名用户" 评论用户名称 1.3.0
└会员头像链接 avatar_img String 1.jpg 会员头像链接 1.4.0
└评论内容 content String 评论内容 1.3.0
└评论星级 rank Int 评论星级 1.3.0
└商品属性 goods_attr String 白色,xl 1.4.0
└评论图片 picture Array 评论图片 1.4.0
└评论时间 add_time String "2010-01-13" 评论时间 1.3.0
└管理员回复内容 reply_content String 管理员回复内容 1.3.0
└管理员名称 reply_username String 管理员名称 1.4.0
└管理员回复时间 reply_add_time String "2010-01-13 15:07:58" 管理员回复时间 1.3.0
└管理员邮箱 re_email String 管理员邮箱 1.3.0 1.4.0
分页信息 paginated Json 分页信息 1.3.0
└总条数 total Int 总条数 1.3.0
└当前返回数组的总条数 count Int 当前返回数组的总条数 1.3.0
└是否有下一页 more Int 1:有下一页,0:没有下一页 是否有下一页 1.3.0

成功举例如下

{ 
      "data": {
            "comment_percent" : "90%",
            "comment_number" : {
                "all" : 200,
                "good" : 180,
                "general" : 18,
                "low" : 2,
                "picture": 80,
            },
            "list":[{
               "id" : "201",
               "author" : "匿名用户",
               "avatar_img" : "http://ecjia.com/data/avatar/000/00/00/33_.jpg",
               "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
      }
}

失败举例如下

注:错误编码