## 1.16. ProductCtl ./shop/controllers/ProductCtl.php ### 1.16.1. 首页 #### 1.16.1.1. 请求URL api.php?ctl=Product&met=index&typ=json #### 1.16.1.2. 返回数据 ~~~json { } ~~~ ### 1.16.2. 管理界面 #### 1.16.2.1. 请求URL api.php?ctl=Product&met=manage&typ=json #### 1.16.2.2. 返回数据 ~~~json { } ~~~ ### 1.16.3. 列表数据, 不论用户是否登录，收藏等等数据不做处理。 #### 1.16.3.1. 请求URL api.php?ctl=Product&met=lists&typ=json #### 1.16.3.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | category\_id | int | 描述 | | store\_id | int | 描述 | | brand\_id | int | 描述 | | keyword | string | 描述 | | keywords | string | 描述 | | user\_cart\_quantity | int | 描述 | #### 1.16.3.3. 返回数据 ~~~json { } ~~~ ### 1.16.4. 接口名称 #### 1.16.4.1. 请求URL api.php?ctl=Product&met=listName&typ=json #### 1.16.4.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | category\_id | int | 描述 | | store\_id | int | 描述 | | brand\_id | int | 描述 | #### 1.16.4.3. 返回数据 ~~~json { } ~~~ ### 1.16.5. 读取 #### 1.16.5.1. 请求URL api.php?ctl=Product&met=item&typ=json #### 1.16.5.2. 返回数据 ~~~json { } ~~~ ### 1.16.6. 通過item\_id或者product\_id获取商品详情 #### 1.16.6.1. 请求URL api.php?ctl=Product&met=detail&typ=json #### 1.16.6.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | item\_id | int | 描述 | | id | int | 描述 | | product\_id | int | 描述 | | id | int | 描述 | | comment\_flag | int | 描述 | #### 1.16.6.3. 返回数据 ~~~json { } ~~~ ### 1.16.7. 读取 #### 1.16.7.1. 请求URL api.php?ctl=Product&met=quick&typ=json #### 1.16.7.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | item\_id | int | 描述 | | id | int | 描述 | | product\_id | int | 描述 | | id | int | 描述 | #### 1.16.7.3. 返回数据 ~~~json { } ~~~ ### 1.16.8. 读取 #### 1.16.8.1. 请求URL api.php?ctl=Product&met=info&typ=json #### 1.16.8.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | item\_id | int | 描述 | | id | int | 描述 | #### 1.16.8.3. 返回数据 ~~~json { } ~~~ ### 1.16.9. 删除操作 #### 1.16.9.1. 请求URL api.php?ctl=Product&met=remove&typ=json #### 1.16.9.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | product\_id | string | 描述 | #### 1.16.9.3. 返回数据 ~~~json { } ~~~ ### 1.16.10. 修改 #### 1.16.10.1. 请求URL api.php?ctl=Product&met=edit&typ=json #### 1.16.10.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | product\_id | string | 产品id | | product\_name | string | 产品名称 | | product\_tips | string | 商品广告词-商品卖点 | | store\_id | int | 店铺id | | store\_name | string | 店铺名称 | | product\_market\_price | float | 市场价 | | product\_unit\_price | float | 商品单价 | | product\_cost\_price | float | 成本价 | | product\_number | string | 商品编号-货号 | | product\_barcode | string | 商品条形码 | | product\_image | string | 商品主图 | | product\_sale\_time | string | 预设上架时间-发布时间 | | product\_is\_lock | int | 是否锁定 - 参加团购的商品不予许修改 | #### 1.16.10.3. 返回数据 ~~~json { } ~~~ ### 1.16.11. 接口名称 #### 1.16.11.1. 请求URL api.php?ctl=Product&met=manufacturer&typ=json #### 1.16.11.2. 返回数据 ~~~json { } ~~~ ### 1.16.12. 接口名称 #### 1.16.12.1. 请求URL api.php?ctl=Product&met=compare&typ=json #### 1.16.12.2. 返回数据 ~~~json { } ~~~ ### 1.16.13. 接口名称 #### 1.16.13.1. 请求URL api.php?ctl=Product&met=search&typ=json #### 1.16.13.2. 返回数据 ~~~json { } ~~~ ### 1.16.14. 接口名称 #### 1.16.14.1. 请求URL api.php?ctl=Product&met=treeview&typ=json #### 1.16.14.2. 返回数据 ~~~json { } ~~~ ### 1.16.15. 接口名称 #### 1.16.15.1. 请求URL api.php?ctl=Product&met=category&typ=json #### 1.16.15.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | category\_id | int | 描述 | | recursive | int | 描述 | #### 1.16.15.3. 返回数据 ~~~json { } ~~~ ### 1.16.16. 接口名称 #### 1.16.16.1. 请求URL api.php?ctl=Product&met=brand&typ=json #### 1.16.16.2. 返回数据 ~~~json { } ~~~ ### 1.16.17. 接口名称 #### 1.16.17.1. 请求URL api.php?ctl=Product&met=test&typ=json #### 1.16.17.2. 返回数据 ~~~json { } ~~~ ### 1.16.18. 商品评价 #### 1.16.18.1. 请求URL api.php?ctl=Product&met=comment&typ=json #### 1.16.18.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | item\_id | int | 描述 | | product\_id | int | 描述 | | comment\_id | int | 描述 | | page | int | 当前页码 | | rows | int | 每页记录条数 | | only\_has\_pic | int | 是否只加载包含图片的评论 | | sidx | string | 排序字段 | | sord | string | 排序方式: ASC | DESC | | comment\_type | int | 描述 | #### 1.16.18.3. 返回数据 ~~~json { } ~~~ ### 1.16.19. 商品问答 #### 1.16.19.1. 请求URL api.php?ctl=Product&met=faq&typ=json #### 1.16.19.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | product\_id | int | 描述 | | ask\_question | string | 描述 | | page | int | 当前页码 | | rows | int | 每页记录条数 | | sidx | string | 排序字段 | | sord | string | 排序方式: ASC | DESC | #### 1.16.19.3. 返回数据 ~~~json { } ~~~ ### 1.16.20. 评论回复 #### 1.16.20.1. 请求URL api.php?ctl=Product&met=addCommentReply&typ=json #### 1.16.20.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | comment\_id | int | 描述 | | text | string | 描述 | #### 1.16.20.3. 返回数据 ~~~json { } ~~~ ### 1.16.21. 评论点赞 #### 1.16.21.1. 请求URL api.php?ctl=Product&met=commentHelpful&typ=json #### 1.16.21.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | comment\_id | int | 描述 | #### 1.16.21.3. 返回数据 ~~~json { } ~~~ ### 1.16.22. 配送区域信息及运费 #### 1.16.22.1. 请求URL api.php?ctl=Product&met=shippingDistrict&typ=json #### 1.16.22.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | item\_id | int | 描述 | | district\_id | int | 描述 | | district\_ids | string | 描述 | #### 1.16.22.3. 返回数据 ~~~json { } ~~~ ### 1.16.23. 接口名称 #### 1.16.23.1. 请求URL api.php?ctl=Product&met=getSpec&typ=json #### 1.16.23.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | product\_id | int | 描述 | #### 1.16.23.3. 返回数据 ~~~json { } ~~~