feat(admin): 添加1688商品类目获取功能

- 在路由中新增 category 接口
- 实现 Goods 控制器中的 category 方法
- 添加 ProductService 的 getCategories 服务方法
- 集成 alibaba.category.get-1 API 接口
- 支持通过 categoryId 参数获取指定类目信息
- 提供完整的 API 文档注释

app/controller/admin/alibaba/Goods.php

@@ -151,4 +151,32 @@ class Goods
 
         return app('json')->fail('入库失败：' . implode('; ', array_values($result['fail'])));
     }
+
+    /**
+     * 获取1688商品类目列表
+     *
+     * API: com.alibaba.product:alibaba.category.get-1
+     * 文档: https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.product%3Aalibaba.category.get-1
+     *
+     * @param ProductService $productService
+     * @return mixed
+     *
+     * @api {GET} /admin/alibaba/goods/category 获取商品类目
+     * @apiParam {string}  [access_token]  1688 access_token（不传则使用配置中的默认token）
+     * @apiParam {int}     [categoryId=0]  类目ID，顶级类目传0
+     */
+    public function category(ProductService $productService)
+    {
+        $request = app('request');
+
+        $categoryId = (int)$request->param('categoryId', 0);
+
+        $result = $productService->getCategories($categoryId);
+
+        if ($result === false) {
+            return app('json')->fail('获取1688商品类目失败，请查看日志!');
+        }
+
+        return app('json')->success($result);
+    }
 }

app/services/ThirdParty/AlibabaAgent/ProductService.php

@@ -741,4 +741,33 @@ class ProductService extends AlibabaAgentBaseService
             'fail'    => $fail,
         ];
     }
+
+    /**
+     * 获取1688商品类目列表
+     *
+     * API: com.alibaba.product:alibaba.category.get-1
+     *
+     * @param string $categoryId 类目ID，顶级类目传0
+     * @return array|false
+     */
+    public function getCategories(string $categoryId = '0')
+    {
+        $businessParams = [
+            'categoryID' => $categoryId,
+        ];
+
+        $result = $this->executeParam2(
+            'com.alibaba.product',
+            'alibaba.category.get',
+            1,
+            $businessParams
+        );
+
+        if ($result === false) {
+            return false;
+        }
+
+        // 返回结果中的 categoryInfo 字段包含类目列表
+        return $result['result']['categoryInfo'] ?? $result['categoryInfo'] ?? [];
+    }
 }

route/admin.php

@@ -718,6 +718,7 @@ Route::group(config('admin.api_admin_prefix') . '/', function () {
             Route::get('lst', '/lst')->name('alibabaGoodsLst');
             Route::get('detail', '/detail')->name('alibabaGoodsDetail');
             Route::post('import', '/import')->name('alibabaGoodsImport');
+            Route::get('category', '/category')->name('alibabaGoodsCategory');
         })->prefix('admin.alibaba.Goods');