dingding/application/api/controller/Goods.php

<?php

namespace app\api\controller;

use app\common\service\GoodsService;
use hg\apidoc\annotation as Apidoc;

/**
 * @Apidoc\Title("商品")
 * @Apidoc\Group("api")
 * @Apidoc\Sort("14")
 */
class Goods extends Base
{
    // 需要登录
    protected $need_login = [];

    public function initialize()
    {
        parent::initialize();
    }

    /**
     * 商品列表
     *
     * @Apidoc\Method("POST")
     * @Apidoc\Param("category_id", type="integer", require=false, desc="二级分类ID")
     * @Apidoc\Param("search", type="string", require=false, desc="搜索 商品名称")
     * @Apidoc\Returned("id", type="integer", desc="商品ID")
     * @Apidoc\Returned("goods_name", type="integer", desc="商品名称")
     * @Apidoc\Returned("sort", type="integer", desc="权重")
     * @Apidoc\Returned("goods_stock", type="array", desc="规格列表",
     *     @Apidoc\Returned("id", type="integer", desc="规格ID"),
     *     @Apidoc\Returned("goods_id", type="integer", desc="商品ID"),
     *     @Apidoc\Returned("name", type="string", desc="规格名称"),
     *     @Apidoc\Returned("stock", type="string", desc="剩余库存"),
     * )
     */
    public function get_list()
    {
        $category_id = input('category_id') ?: 0;
        $search = input('search') ?: '';
        $data = GoodsService::get_list($category_id, $search);
        $this->success('商品列表', $data);
    }

}