@gt6/sdk 1.0.30 → 1.0.32

package/dist/gt6-sdk.esm.js

@@ -124,7 +124,7 @@ class ArticlesAPI {
     async getCategories_p(rootCategoryId_p) {
         const config = this.client.getConfig();
         const categoryId = rootCategoryId_p || config.rootCategoryId_p || '671920';
-        const response = await this.client.request(`/article-categories/platform-${config.platformId_p}-root-${categoryId}.json`);
+        const response = await this.client.request(`/article-categories/platform/platform-${config.platformId_p}-root-${categoryId}.json`);
         return response.categories;
     }
     /**
@@ -154,6 +154,25 @@ class ArticlesAPI {
         const response = await this.client.request(`/article-tags/platform-${config.platformId_p}-${alias}.json`);
         return response.tags;
     }
+    /**
+     * 3.2. 获取单个平台文章标签列表
+     */
+    async getTags_p_single(tagId_p) {
+        const config = this.client.getConfig();
+        const tagId = tagId_p || config.tagId_p;
+        if (!tagId) {
+            throw new Error('Article tag ID is required');
+        }
+        const response = await this.client.request(`/article-tags/${tagId}.json`);
+        return response;
+    }
+    /**
+     * 3.3. 获取单个平台文章标签的文章ID列表
+     */
+    async getTagArticleIds_p(tagId_p) {
+        const tagData = await this.getTags_p_single(tagId_p);
+        return tagData.articleIds;
+    }
     /**
      * 4. 根据分类ID获取文章列表
      * 支持单个分类ID或分类ID数组
@@ -464,6 +483,48 @@ class ArticlesAPI {
             limit
         };
     }
+    /**
+     * 5.3. 根据单个标签ID获取平台文章列表
+     * 使用getTags_p_single获取指定标签数据，然后获取文章详情
+     * @param tagId 单个标签ID
+     * @param options 查询选项
+     */
+    async getArticlesByTag_single(tagId, options) {
+        // 获取指定标签的数据
+        const tagData = await this.getTags_p_single(tagId);
+        if (!tagData || !tagData.articleIds || tagData.articleIds.length === 0) {
+            // 剔除articleIds字段
+            const { articleIds, ...tagInfo } = tagData;
+            return {
+                articles: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10,
+                tag: tagInfo
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedArticleIds = tagData.articleIds.slice(offset, offset + limit);
+        // 获取文章详情
+        const articles = await Promise.all(paginatedArticleIds.map(articleId => this.getArticle_p(articleId)));
+        // 应用状态过滤
+        let filteredArticles = articles;
+        if (options?.status) {
+            filteredArticles = articles.filter(article => article.status === options.status);
+        }
+        // 剔除articleIds字段
+        const { articleIds, ...tagInfo } = tagData;
+        return {
+            articles: filteredArticles,
+            total: tagData.articleIds.length,
+            page,
+            limit,
+            tag: tagInfo
+        };
+    }
     /**
      * 6. 根据分类ID获取该分类的层级路径
      * 用于前端面包屑导航
@@ -697,7 +758,7 @@ class ProductsAPI {
     async getCategories_p(productRootCategoryId_p) {
         const config = this.client.getConfig();
         const categoryId = productRootCategoryId_p || config.productRootCategoryId_p;
-        const response = await this.client.request(`/product-categories/platform-${config.platformId_p}-root-${categoryId}.json`);
+        const response = await this.client.request(`/product-categories/platform/platform-${config.platformId_p}-root-${categoryId}.json`);
         return response.categories;
     }
     /**
@@ -727,6 +788,25 @@ class ProductsAPI {
         const response = await this.client.request(`/product-tags/platform-${config.platformId_p}-${alias}.json`);
         return response.tags;
     }
+    /**
+    * 3.2. 获取单个平台产品标签列表
+    */
+    async getTags_p_single(productTagId_p) {
+        const config = this.client.getConfig();
+        const productTagId = productTagId_p || config.productTagId_p;
+        if (!productTagId) {
+            throw new Error('Product tag ID is required');
+        }
+        const response = await this.client.request(`/product-tags/${productTagId}.json`);
+        return response;
+    }
+    /**
+     * 3.3. 获取单个平台产品标签的产品ID列表
+     */
+    async getTagProductIds_p(productTagId_p) {
+        const tagData = await this.getTags_p_single(productTagId_p);
+        return tagData.productIds;
+    }
     /**
      * 4. 根据分类ID获取产品列表
      * 支持单个分类ID或分类ID数组
@@ -1091,6 +1171,48 @@ class ProductsAPI {
             limit
         };
     }
+    /**
+     * 5.3. 根据单个标签ID获取平台产品列表
+     * 使用getTags_p_single获取指定标签数据，然后获取产品详情
+     * @param tagId 单个标签ID
+     * @param options 查询选项
+     */
+    async getProductsByTag_single(tagId, options) {
+        // 获取指定标签的数据
+        const tagData = await this.getTags_p_single(tagId);
+        if (!tagData || !tagData.productIds || tagData.productIds.length === 0) {
+            // 剔除productIds字段
+            const { productIds, ...tagInfo } = tagData;
+            return {
+                products: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10,
+                tag: tagInfo
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedProductIds = tagData.productIds.slice(offset, offset + limit);
+        // 获取产品详情
+        const products = await Promise.all(paginatedProductIds.map(productId => this.getProduct_p(productId)));
+        // 应用状态过滤
+        let filteredProducts = products;
+        if (options?.status !== undefined) {
+            filteredProducts = products.filter(product => product.status === options.status);
+        }
+        // 剔除productIds字段
+        const { productIds, ...tagInfo } = tagData;
+        return {
+            products: filteredProducts,
+            total: tagData.productIds.length,
+            page,
+            limit,
+            tag: tagInfo
+        };
+    }
     /**
      * 6. 根据分类ID获取该分类的层级路径
      * 用于前端面包屑导航
@@ -2675,6 +2797,18 @@ class GT6SDK {
     async getTags_p(tagAlias_p) {
         return this.articles.getTags_p(tagAlias_p);
     }
+    /**
+     * 3.2. 便捷方法：获取单个平台文章标签列表
+     */
+    async getTags_p_single(tagId_p) {
+        return this.articles.getTags_p_single(tagId_p);
+    }
+    /**
+     * 3.3. 便捷方法：获取单个平台文章标签的文章ID列表
+     */
+    async getTagArticleIds_p(tagId_p) {
+        return this.articles.getTagArticleIds_p(tagId_p);
+    }
     /**
      * 4. 便捷方法：根据分类ID获取文章列表
      */
@@ -2717,6 +2851,12 @@ class GT6SDK {
     async getArticlesByTag_t(tagId, options) {
         return this.articles.getArticlesByTag_t(tagId, options);
     }
+    /**
+     * 5.3. 便捷方法：根据单个标签ID获取平台文章列表
+     */
+    async getArticlesByTag_single(tagId, options) {
+        return this.articles.getArticlesByTag_single(tagId, options);
+    }
     /**
      * 6. 便捷方法：根据分类ID获取该分类的层级路径
      */
@@ -2771,6 +2911,18 @@ class GT6SDK {
     async getProductTags_p(productTagAlias_p) {
         return this.products.getTags_p(productTagAlias_p);
     }
+    /**
+     * 10.2. 便捷方法：获取单个平台产品标签列表
+     */
+    async getProductTags_p_single(productTagId_p) {
+        return this.products.getTags_p_single(productTagId_p);
+    }
+    /**
+     * 10.3. 便捷方法：获取单个平台产品标签的产品ID列表
+     */
+    async getProductTagProductIds_p(productTagId_p) {
+        return this.products.getTagProductIds_p(productTagId_p);
+    }
     /**
      * 11. 便捷方法：根据分类ID获取产品列表
      */
@@ -2813,6 +2965,12 @@ class GT6SDK {
     async getProductsByTag_t(tagId, options) {
         return this.products.getProductsByTag_t(tagId, options);
     }
+    /**
+     * 12.3. 便捷方法：根据单个标签ID获取平台产品列表
+     */
+    async getProductsByTag_single(tagId, options) {
+        return this.products.getProductsByTag_single(tagId, options);
+    }
     /**
      * 13. 便捷方法：根据分类ID获取该分类的层级路径
      */