| 后一修订版 | 前一修订版 | ||
|
评论 [2016/05/24 19:00] lyy 创建 |
评论 [2017/06/01 13:59] (当前版本) |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| ====== 评论接口 ====== | ====== 评论接口 ====== | ||
| ------ | ------ | ||
| - | ===== 1、退款列表 ===== | + | ===== 1、评论列表 ===== |
| === 接口名称 === | === 接口名称 === | ||
| - | back-orders/list | + | buyer-comments/list |
| === 请求方式 === | === 请求方式 === | ||
| get | get | ||
| 行 10: | 行 10: | ||
| ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | ||
| | buyerId| int | 是 | 买家id | | | buyerId| int | 是 | 买家id | | ||
| - | | backNo| string| 否 | 退款编号| | ||
| - | | startTime| date| 否 | 款创建开始时间| | ||
| - | | endTime| date| 否 | 款创建结束时间 | | ||
| - | | status| int | 否 | 退款状态 (退货单状态 0:申请中,1退款成功 2退款失败3取消,5待退货,6已退货) | | ||
| - | | productName| string| 否 | 产品名称 | | ||
| |pageSize|int|否|每页数量 默认为50| | |pageSize|int|否|每页数量 默认为50| | ||
| === 返回值 === | === 返回值 === | ||
| 行 23: | 行 18: | ||
| === items数据说明 === | === items数据说明 === | ||
| ^ 名称 ^ 类型 ^ 说明 ^ | ^ 名称 ^ 类型 ^ 说明 ^ | ||
| - | | back_id| int| 退款ID| | + | | id| int| 评论ID| |
| - | | backno| string| 退款编号 | | + | |
| | order_id| int| 订单ID | | | order_id| int| 订单ID | | ||
| | buyer_id| int| 买家ID | | | buyer_id| int| 买家ID | | ||
| | seller_id| int|卖家id | | | seller_id| int|卖家id | | ||
| | order_detail_id| int| 订单详情id | | | order_detail_id| int| 订单详情id | | ||
| - | | add_time| string| 添加时间| | + | | addtime| string| 添加时间| |
| - | | back_type| number| 退款类型| | + | | product_id| number| 产品id| |
| - | | backnote| number| 退款备注 | | + | | product_sku_id| number| 产品sku id | |
| - | | backaddress| string| 退货地址 | | + | | description| int| 描述评分 | |
| - | | backaddressId| int| 退货地址id | | + | | service| int| 服务评分 | |
| - | | backconsignee| string| 退货收件人 | | + | | express| int| 快递评分 | |
| - | | back_mobile| string| 退货手机号 | | + | | cnt| string| 评论内容 | |
| - | | back_price| string| 退款金额 | | + | | reply| string| 回复内容 | |
| - | | back_pic| string| 退款图片 | | + | | memberName| string| 会员名称 | |
| - | | shipping_name| string| 快递名称 | | + | | memberAvatar| string| 会员头像 | |
| - | | update_time| string| 退款时间 | | + | | productInfo| array| 产品信息 ''Array |
| - | | shipping_id| string| 快递id | | + | ( |
| - | | invoice_no| string| 退款运单号 | | + | [properties_name] => 颜色:红色,大小:X,套餐:电信 |
| - | | status| int|订单状态订单状态 (退货单状态 0:申请中,1退款成功 2退款失败3取消,5待退货,6已退货 ) | | + | [name] => 432432432 |
| - | | | + | [price] => 22.00 |
| - | | details| array| 订单产品信息<code> { | + | [shop_name] => 这是衣服店2 |
| - | "id": "43", //订单详情id | + | [business_id] => 1 |
| - | "orders_id": "26",//订单ID | + | [pic1] =>产品图片 |
| - | "product_id": "3",//产品ID | + | ) |
| - | "sku_id": "3",//产品SKU ID | + | '' | |
| - | "product_name": "432432432",//产品名称 | + | |imgs|array|评论图片''Array |
| - | "properties": "颜色:红色,大小:X,套餐:电信",//SKU属性 | + | ( |
| - | "quantity": "2",//购买数量 | + | [0] => http://pic.8dage.net/data/uploadfile/images/1/20160527/78b0ad56dc.jpg |
| - | "price": "22.00",//单价 | + | [1] => http://pic.8dage.net/data/uploadfile/images/1/20160606/3ada052983.jpg |
| - | "total": "44.00",//小计 | + | ) |
| - | "cost": "46.00",//成本价 | + | ''| |
| - | "back_status": "0",//退款状态(0没有退款,1申请中,2退款成功,3退款失败,4退款中) | + | |
| - | "pic1": "http://pic.8dage.net/data/uploadfile/images/1/20160504/6c50be469f.png"////产品图片 | + | ===== 2、根据产品id获取评论 ===== |
| - | }</code> | | + | |
| - | ===== 2、退款单详情 ===== | ||
| === 接口名称 === | === 接口名称 === | ||
| - | back-orders/detail | + | buyer-comments/product-comment |
| === 请求方式 === | === 请求方式 === | ||
| get | get | ||
| === 请求参数 === | === 请求参数 === | ||
| ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | ||
| - | | buyerId| int | 是 | 买家id | | + | | productId| int | 是 | 产品id | |
| - | | backId| int | 是 | 退款单id | | + | | comType| int | 否 | 评论类型 (默认为0,获取所有的评论 1,好 2中 3差 4有图片) | |
| + | |pageSize|int|否|每页数量 默认为50| | ||
| + | === 返回值 === | ||
| + | ^ 名称 ^ 类型 ^ 说明 ^ | ||
| + | | items| data| 数据 | | ||
| + | | _links| data| 分页信息 | | ||
| + | | _meta| data| 查询数据信息 | | ||
| + | === items数据说明 === | ||
| + | ^ 名称 ^ 类型 ^ 说明 ^ | ||
| + | | buyer_id| int| 买家ID | | ||
| + | | product_id| number| 产品id| | ||
| + | | product_sku_id| number| 产品sku id | | ||
| + | | cnt| string| 评论内容 | | ||
| + | | addtime| string| 评论时间| | ||
| + | | reply| string| 回复内容 | | ||
| + | | comType| int| 评论类型 (1,好 2中 3差 ) | | ||
| + | | memberName| string| 会员名称 | | ||
| + | | memberAvatar| string| 会员头像 | | ||
| + | | productInfo| array| 产品信息 ''Array | ||
| + | ( | ||
| + | [properties_name] => 颜色:红色,大小:X,套餐:电信 | ||
| + | [name] => 432432432 | ||
| + | [price] => 22.00 | ||
| + | [shop_name] => 这是衣服店2 | ||
| + | [business_id] => 1 | ||
| + | [pic1] =>产品图片 | ||
| + | ) | ||
| + | '' | | ||
| + | |imgs|array|评论图片''Array | ||
| + | ( | ||
| + | [0] => http://pic.8dage.net/data/uploadfile/images/1/20160527/78b0ad56dc.jpg | ||
| + | [1] => http://pic.8dage.net/data/uploadfile/images/1/20160606/3ada052983.jpg | ||
| + | ) | ||
| + | ''| | ||
| + | ===== 3、添加评论 ===== | ||
| + | === 接口名称 === | ||
| + | buyer-comments/create | ||
| + | === 请求方式 === | ||
| + | post | ||
| + | === 请求参数 === | ||
| + | ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | ||
| + | | orderId| int| 是 |订单ID | | ||
| + | | buyerId| int| 是 |买家ID | | ||
| + | |commentJson|json|是|评论json<code> | ||
| + | {"sellerId":"61bd959f048d008fe07f1c39a337cc72",//卖家id 必填 | ||
| + | "orderDetailId":"74",//订单详情id 必填 | ||
| + | "productId":"33",//产品id 必填 | ||
| + | "productSkuId":"82",//产品sku id 必填 | ||
| + | "cnt":"sssss",//内容 | ||
| + | "comType":"1",//类型 必填 | ||
| + | "pic":"http:\/\/pic.8dage.net\/data\/uploadfile\/images\/0\/20160705\/f3341a2aba.jpeg"//图片 | ||
| + | } | ||
| + | </code>| | ||
| + | |||
| + | |||
| + | | description| int| 是 |描述评分 | | ||
| + | | service| int| 是 |服务评分 | | ||
| + | | express| int| 是 |快递评分 | | ||
| === 返回值 === | === 返回值 === | ||
| ^ 名称 ^ 类型 ^ 说明 ^ | ^ 名称 ^ 类型 ^ 说明 ^ | ||
| - | | id| int| 订单ID| | + | | result | bool | 返回结果 success 成功 error 失败 | |
| - | | order_no| string| 订单编号 | | + | | message| string | 返回信息 | |
| - | | supplier_id| int| 供货商ID | | + | |
| - | | member_id| int| 买家ID | | + | ===== 4、回复评论 ===== |
| - | | order_type| int|订单类型 1 实物订单 2 积分兑换订单 | | + | === 接口名称 === |
| - | | order_money| number| 订单金额 | | + | buyer-comments/reply |
| - | | discount| number| 折扣 | | + | === 请求方式 === |
| - | | shipping_costs| number| 运费 | | + | post |
| - | | order_total| number| 订单合计金额 | | + | === 请求参数 === |
| - | | pay_money| number| 支付金额 | | + | ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ |
| - | | quantity| int| 合计件数 | | + | | commentId| int| 是 |评论ID | |
| - | | create_time| string| 创建时间 | | + | | sellerId| int|是 |卖家id | |
| - | | pay_time| string| 支付时间 | | + | | reply| string| 是 |回复内容 | |
| - | | ship_time| string| 查询数据信息 | | + | === 返回值 === |
| - | | complete_time| string| 发货时间 | | + | ^ 名称 ^ 类型 ^ 说明 ^ |
| - | | express| int| 配送方式 | | + | | result | bool | 返回结果 success 成功 error 失败 | |
| - | | express_code| string| 运单号 | | + | | message| string | 返回信息 | |
| - | | cancle_time| string| 取消时间 | | + | |
| - | | status| int|订单状态订单状态 0 待付款 1待发货 2待收货 3交易成功 4交易取消5交易关闭 6 取消订单等待卖家处理 | | + | ===== 5、评论列表数量 ===== |
| - | | memos| string| 订单备注 | | + | |
| - | | buyer_feedback| string| 买家留言 | | + | === 接口名称 === |
| - | | is_comment| int| 是否评论 | | + | buyer-comments/product-comment-num |
| - | | backlogs| array| 退款日志<code> { | + | === 请求方式 === |
| - | "log_id": "14",//日志id | + | get |
| - | "back_id": "6",//退款id | + | === 请求参数 === |
| - | "operator_id": "3",//操作者 | + | ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ |
| - | "remark": "买家发起了退款申请,退款原因:7天无理由退换货,退款说明:尺码拍错了,退款金额:23",//退款内容 | + | | productId| int | 是 | 产品id | |
| - | "add_time": "1464072016",//时间 | + | === 返回值 === |
| - | "status": "0",//退货单状态 1:申请中,2退款成功 3退款失败 4取消,5待退货,6已退货 | + | | allCount| int| 所有评论数量| |
| - | "log_title": "买家发起了申请",//日志标题 | + | | picCount| int| 图片 | |
| - | "pic": ""//退款图片 | + | | goodCount| int| 好评 | |
| - | }</code> | | + | | mediumCount| int|中评 | |
| - | | ordersDetail| array| 订单产品信息<code> { | + | | badCount| int| 差评 | |
| - | "id": "43", //订单详情id | + | |
| - | "orders_id": "26",//订单ID | + | |
| - | "product_id": "3",//产品ID | + | |
| - | "sku_id": "3",//产品SKU ID | + | |
| - | "product_name": "432432432",//产品名称 | + | |
| - | "properties": "颜色:红色,大小:X,套餐:电信",//SKU属性 | + | |
| - | "quantity": "2",//购买数量 | + | |
| - | "price": "22.00",//单价 | + | |
| - | "total": "44.00",//小计 | + | |
| - | "cost": "46.00",//成本价 | + | |
| - | "back_status": "0",//退款状态(0没有退款,1申请中,2退款成功,3退款失败,4退款中) | + | |
| - | "pic1": "http://pic.8dage.net/data/uploadfile/images/1/20160504/6c50be469f.png"////产品图片 | + | |
| - | }</code> | | + | |