sgd

app/data/controller/api/Goods.php

@@ -23,7 +23,7 @@ use hg\apidoc\annotation\Returned;
 class Goods extends Auth
 {
     /**
-     * 获取分类数据
+     * @Title ("获取分类数据")
      * @throws \think\db\exception\DataNotFoundException
      * @throws \think\db\exception\DbException
      * @throws \think\db\exception\ModelNotFoundException
@@ -42,7 +42,7 @@ class Goods extends Auth
     }
 
     /**
-     * 获取商品数据
+     * @Param ("获取商品数据")
      * @throws \think\db\exception\DataNotFoundException
      * @throws \think\db\exception\DbException
      * @throws \think\db\exception\ModelNotFoundException
@@ -97,11 +97,12 @@ class Goods extends Auth
     }
 
     /**
+     * @Title ("购物车列表")
      * @return void
      * @throws \think\db\exception\DataNotFoundException
      * @throws \think\db\exception\DbException
      * @throws \think\db\exception\ModelNotFoundException
-     * 购物车列表
+     *
      */
     public function goods_cart_list(){
         $user = $this->getUser();
@@ -116,8 +117,9 @@ class Goods extends Auth
     }
 
     /**
-     * @return void
-     * 购物车修改
+     * @Title ("修改购物车")
+     * @Param ("cart_id",desc("购物车id"))
+     * @Param ("num",desc("数量"))
      */
     public function goods_cart_save(){
         $user = $this->getUser();
@@ -129,8 +131,8 @@ class Goods extends Auth
     }
 
     /**
-     * @return void
-     * 购物车删除啊
+     * @Title ("删除购物车")
+     * @Param ("cart_ids",desc("购物车id"))
      */
     public function goods_cart_del(){
         $user = $this->getUser();
@@ -140,6 +142,7 @@ class Goods extends Auth
     }
     /**
      * @Title ("添加我的收藏")
+     * @Param ("goods_id",desc("商品id"))
      */
     public function collection(){
         $user =$this->getUser();
@@ -149,6 +152,7 @@ class Goods extends Auth
     }
     /**
      * @Title ("删除我的收藏")
+     * @Param ("coll_ids",desc("收藏id"))
      */
     public function del_collection(){
         $user = $this->getUser();

app/data/controller/api/Order.php

@@ -72,8 +72,8 @@ class Order extends Auth
     /**
      * @Title("我的订单")
      * @Method("post")
-     * @Param("cart_ids",desc="购物车id(数组)")
-     * @Param ("address_id",desc="地址id")
+     * @Param("order_name",desc="搜索名称")
+     * @Param ("status",desc="1全部 2 待支付 3代发货 4 待收货 5退款/已退款")
      */
     public function order_list(){
         $user = $this->getUser();

app/data/controller/api/User.php

@@ -9,19 +9,33 @@ use hg\apidoc\annotation\Method;
 use hg\apidoc\annotation\Param;
 use hg\apidoc\annotation\Returned;
 
-
+/**
+ * 用户收货地址
+ * Class User
+ * @package app\data\controller\api
+ */
 class User extends Auth
 {
     protected $noNeedLogin=[];
-
+    /**
+     * @Title("地址列表")
+     */
     public function address_list(){
         $user= $this->getUser();
         $list = DataUserAddress::mk()->where('uuid',$user['id'])->where('deleted',1)->paginate();
         $this->success('我的地址列表',$list);
     }
     /**
+     * @Title ("添加收货地址")
+     * @param ("type",desc("默认 1"))
+     * @param ("name",desc("收货名称"))
+     * @param ("phone",desc("手机号"))
+     * @param ("province",desc("省份  传文字"))
+     * @param ("city",desc("城市"))
+     * @param ("area",desc("区县"))
+     * @param ("address",desc("详细的地址"))
      * @return void
-     * 添加快递地址
+     *
      */
     public function add_address(){
         $user = $this->getUser();
@@ -55,6 +69,14 @@ class User extends Auth
     }
 
     /**
+     * @Title ("编辑收货地址")
+     * @param ("type",desc("默认 1"))
+     * @param ("name",desc("收货名称"))
+     * @param ("phone",desc("手机号"))
+     * @param ("province",desc("省份  传文字"))
+     * @param ("city",desc("城市"))
+     * @param ("area",desc("区县"))
+     * @param ("address",desc("详细的地址"))
      * @return void
      * 编辑用户地址
      */
@@ -90,8 +112,10 @@ class User extends Auth
     }
 
     /**
+     * @Title (“删除啊收货地址”)
+     * @param ("id",desc("地址的id"))
      * @return void
-     * 删除快递地址
+     *
      */
     public function del_address(){
         $user = $this->getUser();

config/apidoc.php

@@ -28,7 +28,7 @@ return [
                         \app\data\controller\api\Order::class,
 
 
-                        \app\data\controller\api\auth\Address::class,
+//                        \app\data\controller\api\auth\Address::class,