Fecify Skill 基础 API 索引(下)

接上篇。不含工作流,每个 API 含路径、方法、用途、文档链接。


10. 菜单管理 (Menu) — 6 个

# API 路径 方法 用途 文档
1 菜单树列表 /api/skill/menu/list GET 浏览所有已创建的菜单树(仅返回第一级节点),分页返回 docs/menu/list.md
2 菜单树详情 /api/skill/menu/info GET 获取指定菜单树的完整结构(全部层级/所有节点/URL/标题/图标/打开方式) docs/menu/info.md
3 创建菜单树 /api/skill/menu/create POST 创建新菜单树:含名称/多层级节点/每节点含title/URL/icon/type/open_type docs/menu/create.md
4 更新菜单树 /api/skill/menu/update POST 全量替换菜单树结构(传入完整JSON树覆盖原有节点,不可部分更新) docs/menu/update.md
5 删除菜单树 /api/skill/menu/delete POST 删除指定菜单树及其全部节点(不可恢复) docs/menu/delete.md
6 URL 选择器 /api/skill/menu/get-item-types GET 获取菜单项可选的链接类型列表(如首页/商品/专辑/页面/博客/外部URL等枚举) docs/menu/url-select.md

11. 系统物流 (Shipping) — 11 个

物流方案

# API 路径 方法 用途 文档
1 列表 /api/skill/shipping/get-shipping-list GET 获取所有物流方案及其关联的配送区域(Zone),每个方案展示名称/状态和区域列表 docs/shipping/shipping-list.md
2 详情 /api/skill/shipping/get-shipping-info GET 获取单个物流方案的当前配置(名称/描述/类型),更新前必须调用 docs/shipping/shipping-info.md
3 创建 /api/skill/shipping/create-shipping POST 新增物流方案:含名称/描述/类型/启用状态,创建后可添加配送区域 docs/shipping/shipping-create.md
4 更新 /api/skill/shipping/update-shipping POST 全量更新物流方案配置(名称/描述/类型/状态),覆盖所有字段 docs/shipping/shipping-update.md
5 修改状态 /api/skill/shipping/change-shipping-status POST 单独启用或停用指定物流方案(只传 id+status,不改其他字段) docs/shipping/shipping-change-status.md
6 删除 /api/skill/shipping/delete-shipping POST 删除物流方案及其所有配送区域(不可恢复) docs/shipping/shipping-delete.md

配送区域

# API 路径 方法 用途 文档
7 已占用国家 /api/skill/shipping/get-shipping-selected-country-and-provinces GET 获取已被其他配送区域占用的国家/省份列表(创建新Zone前用它排查国家冲突) docs/shipping/zone-countries.md
8 详情 /api/skill/shipping/get-shipping-zone-info GET 获取指定配送区域的当前配置(国家/省份/运费规则/重量阶梯/订单金额条件) docs/shipping/zone-info.md
9 创建 /api/skill/shipping/shipping-create-zone POST 为指定物流方案新增配送区域:含国家/省份/运费规则/重量阶梯/起止金额 docs/shipping/zone-create.md
10 更新 /api/skill/shipping/shipping-update-zone POST 全量更新配送区域配置(国家/省份/运费规则等),覆盖所有字段 docs/shipping/zone-update.md
11 删除 /api/skill/shipping/shipping-delete-zone POST 删除指定物流方案下的某个配送区域(不影响物流方案本身) docs/shipping/zone-delete.md

12. 系统税费 (Tax) — 13 个

基础税费

# API 路径 方法 用途 文档
1 列表 /api/skill/tax/get-base-tax-list GET 获取系统中已配置税费的所有国家/地区列表(含税名/税率/启用状态) docs/tax/base-list.md
2 详情 /api/skill/tax/get-base-tax-info GET 获取指定国家的基础税费配置详情(国家税率+各省份/州的州税率) docs/tax/base-info.md
3 保存 /api/skill/tax/save-base-tax POST 设置/更新某国的基础税费:传国家+税率+各州税率JSON,全量覆盖,未传州级则清空 docs/tax/base-save.md
4 修改状态 /api/skill/tax/change-base-tax-status POST 单独启用或停用某国的基础税费(传 country + status,不改税率配置) docs/tax/base-change-status.md

自定义税费方案

# API 路径 方法 用途 文档
5 列表 /api/skill/tax/get-custom-tax-list GET 获取所有自定义税费方案列表(含名称/启用状态/关联商品数等摘要) docs/tax/custom-list.md
6 详情 /api/skill/tax/get-custom-tax-info GET 获取指定自定义税费方案的基本信息(名称/启用状态等) docs/tax/custom-info.md
7 创建 /api/skill/tax/create-custom-tax POST 创建自定义税费方案(传名称即可,后续再配商品和国家税率) docs/tax/custom-create.md
8 更新名称 /api/skill/tax/update-custom-tax POST 修改自定义税费方案的名称(仅改名称,不涉及商品或税率配置) docs/tax/custom-update.md
9 关联商品列表 /api/skill/tax/get-custom-tax-products GET 获取指定自定义税费方案关联的商品列表(分页查询) docs/tax/custom-product-list.md
10 更新关联商品 /api/skill/tax/update-custom-tax-products POST 批量增删自定义税费方案关联的商品:传 add_ids 和 del_ids 数组 docs/tax/custom-product-update.md
11 国家税费列表 /api/skill/tax/get-custom-tax-country-taxs GET 获取指定自定义税费方案下的各国税率配置(含国家+各州税率) docs/tax/custom-country-tax-list.md
12 保存国家税费 /api/skill/tax/save-custom-tax-country-taxs POST 为自定义税费方案设置/更新指定国家的税率(全量覆盖该国+各州税率) docs/tax/custom-country-tax-save.md
13 删除方案 /api/skill/tax/delete-custom-tax POST 删除自定义税费方案(删除后不可恢复,关联商品失去该税费约束) docs/tax/custom-delete.md

13. 权限管理 (Permission) — 13 个

# API 路径 方法 用途 文档
1 资源树 /api/skill/system-user/get-role-resource-tree GET 获取系统完整的权限资源树(所有可分配的功能权限项,树形结构返回) docs/permission/resource-tree.md
2 角色列表 /api/skill/system-user/get-role-list GET 浏览/搜索角色列表(按角色名称搜索),返回每个角色的名称/描述/操作员数 docs/permission/role-list.md
3 角色详情 /api/skill/system-user/get-role-info GET 获取指定角色的完整信息(名称/描述/已分配的权限资源ID数组) docs/permission/role-info.md
4 创建角色 /api/skill/system-user/create-role POST 新建角色并分配权限:传角色名称/描述 + 资源ID数组(资源ID来自资源树) docs/permission/role-create.md
5 更新角色 /api/skill/system-user/update-role POST 全量更新角色信息(名称/描述/权限资源ID数组),覆盖所有字段,传完整权限集 docs/permission/role-update.md
6 删除角色 /api/skill/system-user/delete-role POST 删除指定角色(需确保没有操作员绑定该角色,否则删除失败) docs/permission/role-delete.md
7 操作员列表 /api/skill/system-user/get-user-list GET 浏览/搜索操作员列表(按昵称/邮箱搜索),返回昵称/头像/状态/角色 docs/permission/user-list.md
8 操作员详情 /api/skill/system-user/get-user-info GET 获取指定操作员详情:昵称/头像/邮箱/状态/绑定的角色ID docs/permission/user-info.md
9 创建操作员 /api/skill/system-user/create-user POST 创建新操作员并绑定角色:传昵称/邮箱/密码/头像/状态/角色ID docs/permission/user-create.md
10 更新操作员 /api/skill/system-user/update-user POST 全量更新操作员信息(昵称/密码/头像/状态/角色),覆盖所有字段 docs/permission/user-update.md
11 改状态 /api/skill/system-user/update-user-status POST 仅修改操作员的启用/禁用状态(只传 id + status,不改角色/昵称等) docs/permission/user-status.md
12 改角色 /api/skill/system-user/update-user-role POST 仅修改操作员绑定的角色(只传 manager_id + role_id) docs/permission/user-role.md
13 删除操作员 /api/skill/system-user/delete-user POST 删除指定操作员(传 ids 数组),删除后该管理员无法再登录后台 docs/permission/user-delete.md

14. 数据统计 (Statistics) — 7 个

# API 路径 方法 店铺 用途 文档
1 B2C 概览 /api/skill/overview/b2c-shop GET B2C 仪表盘概览:商品总数/顾客数/订单数/询盘数/退款金额/今日趋势 docs/statistics/b2c-dashboard.md
2 B2B 概览 /api/skill/overview/b2b-shop GET B2B 仪表盘概览:商品总数/顾客数/询盘数/今日趋势 docs/statistics/b2b-dashboard.md
3 顾客统计 /api/skill/data/get-customer-data GET 通用 按时间区间查询顾客新增/注册/邮箱订阅的日级趋势(传start/end/interval) docs/statistics/customer.md
4 订单统计 /api/skill/data/get-order-data GET B2C 按时间区间查询销售额/退款额/客单价/订单数的日级趋势 docs/statistics/order.md
5 商品统计 /api/skill/data/get-product-data GET 通用 按时间区间查询商品创建数+销售量的日级趋势(传start/end/interval) docs/statistics/product.md
6 商品排行 /api/skill/data/get-product-ranking-data GET B2C 按销量或销售额对商品排行榜查询(Top N),返回排名/商品名/sku/销量/金额 docs/statistics/product-sales.md
7 变体排行 /api/skill/data/get-product-variant-ranking-data GET B2C 按变体维度查询销量排行榜(可指定商品),返回各变体sku/选项/销量/金额 docs/statistics/variant-sales.md

15. 系统任务 (Task) — 5 个

# API 路径 方法 用途 文档
1 列表 /api/skill/task/list GET 分页查询系统后台任务列表:按类型/状态筛选,返回任务ID/类型/状态/进度/创建时间 docs/task/list.md
2 详情 /api/skill/task/info GET 获取单个任务详情:含当前进度百分比/执行日志/开始结束时间/错误信息 docs/task/info.md
3 终止 /api/skill/task/end-task POST 手动终止一个正在执行中的任务(仅 status=1 的任务可终止) docs/task/end-task.md
4 状态列表 /api/skill/task/task-status GET 获取任务状态字典列表(5种状态:等待/执行中/完成/失败/取消,含label/name/color) docs/task/status-list.md
5 类型列表 /api/skill/task/task-types GET 获取任务类型字典列表(44种类型如导入/导出/生成/同步等,含label/name) docs/task/types-list.md

16. URL 重定向 (URL Redirect) — 6 个

# API 路径 方法 用途 文档
1 类型列表 /api/skill/redirect/types GET 获取URL重定向的类型枚举列表(301/302等重定向类型选项) docs/url-redirect/types.md
2 列表 /api/skill/redirect/list GET 分页查询URL重定向规则列表:按旧URL/新URL/类型筛选,返回所有手动创建的规则 docs/url-redirect/list.md
3 详情 /api/skill/redirect/info GET 查看单条URL重定向规则详情:旧URL→新URL/类型/创建时间 docs/url-redirect/info.md
4 创建 /api/skill/redirect/create POST 手动创建URL重定向规则:传旧URL+新URL+类型(如301),用户访问旧URL自动跳转 docs/url-redirect/create.md
5 更新 /api/skill/redirect/update POST 全量更新URL重定向规则:传 id + 新配置,覆盖旧URL/新URL/类型 docs/url-redirect/update.md
6 删除 /api/skill/redirect/delete POST 批量删除URL重定向规则(传 id 数组) docs/url-redirect/delete.md

17. 系统配置 (System Settings) — 10 对 (20 个)

每对 = get + set(全量覆盖,先 get 再 set,路径前缀均为 /api/skill

# 配置项 get 路径 set 路径 用途 文档
1 博客显示 /api/skill/blog-article/get /api/skill/blog-article/set 博客文章相关系统设置:如文章每页条数/评论设置等 docs/system-settings/blog-article-settings.md
2 商品配置 /api/skill/product/get-product /api/skill/product/set-product 商品相关系统设置:如商品尺寸单位/库存扣减策略/购物车行为等 docs/system-settings/product-config.md
3 评论配置 /api/skill/product-review/get /api/skill/product-review/set 商品评论相关系统设置:如自动发布/审核模式/通知等 docs/system-settings/product-review-config.md
4 基本设置 /api/skill/system-setting/basic-get /api/skill/system-setting/basic-set 站点基础设置:店名/邮箱/Logo/联系方式/搜索引擎验证等 docs/system-settings/system-basic.md
5 高级设置 /api/skill/system-setting/advance-get /api/skill/system-setting/advance-set 站点高级设置:自定义CSS/JS///订单编号前缀等 docs/system-settings/system-advance.md
6 验证码 /api/skill/system-setting/captcha-get /api/skill/system-setting/captcha-set 验证码设置:启用/禁用/类型/密钥配置等 docs/system-settings/captcha.md
7 交易设置 /api/skill/system-setting/order-get /api/skill/system-setting/order-set 交易/结算配置:订单过期时间/最小金额/自动取消/支付方式等 docs/system-settings/checkout.md
8 国家设置 /api/skill/system-setting/country-get /api/skill/system-setting/country-set 国家/地区设置:默认国家/允许注册的国家/日期格式/时区等 docs/system-settings/country.md
9 缓存设置 /api/skill/system-setting/cache-get /api/skill/system-setting/cache-set 缓存配置:启用/禁用各种缓存/缓存时间等 docs/system-settings/cache.md
10 任务设置 /api/skill/system-setting/task-get /api/skill/system-setting/task-set 任务配置:批量任务大小/超时/并发等 docs/system-settings/task.md

18. 店铺信息 (Shop Info) — 9 个

店铺已启用配置

# API 路径 方法 用途 文档
1 语言列表 /api/skill/base/get-shop-languages POST 获取店铺当前已启用的语言列表(含语言编码和名称) docs/shop-info/languages.md
2 货币列表 /api/skill/base/get-shop-currencys POST 获取店铺已启用的货币列表及汇率 docs/shop-info/currencies.md
3 时区列表 /api/skill/base/get-timezone-list POST 获取Fecify所有可用时区列表 docs/shop-info/timezone.md
4 模板 layout /api/skill/base/get-template-types POST 获取指定页面的所有可用布局模板(如home/article/page等) docs/shop-info/template-types.md

全局固定数据

# API 路径 方法 用途 文档
5 国家与省份 /api/skill/base/get-country-list GET 获取全球国家ISO代码+各国家省份/州列表(无参) docs/shop-info/country-list.md
6 电话区号 /api/skill/base/get-phone-codes GET 获取全球国际电话区号列表(无参) docs/shop-info/phone-codes.md
7 欧洲国家简码 /api/skill/base/get-europe-country-codes GET 获取欧洲国家的ISO简码列表(无参) docs/shop-info/europe-countries.md
8 网站基础 URL /api/skill/base/get-site-base-url GET 获取店铺的附件/后台/API/前台等基础URL(无参) docs/shop-info/site-url.md

缓存

# API 路径 方法 用途 文档
9 刷新缓存 /api/skill/base/reflush-shop-cache GET 刷新系统缓存+Cloudflare缓存,数据变更后调用以确保前台同步 docs/shop-info/refresh-cache.md

19. 图片管理 (Base Image) — 3 个

# API 路径 方法 用途 文档
1 图片列表 /api/skill/base-image/get-image-list GET 分页查询已上传的图片资源列表(可按名称/路径/时间筛选) docs/base-images/image-list.md
2 上传图片 /api/skill/base-image/upload POST 上传图片到服务器,返回图片服务器路径,供后续商品/专辑引用 docs/base-images/image-upload.md
3 删除图片 /api/skill/base-image/delete-images POST 批量删除已上传的图片(传图片ID数组) docs/base-images/image-delete.md

20. 多语言 (Language) — 21 个

插件配置 + 语言管理

# API 路径 方法 用途 文档
1 获取配置 /api/skill/addons-language/get GET 查看多语言插件的系统设置(语言/翻译/显示等配置) docs/language/config-get.md
2 保存配置 /api/skill/addons-language/set POST 保存多语言插件设置(全量覆盖),修改前必须先get docs/language/config-set.md
3 所有语言 /api/skill/addons-language/get-all-languages GET 获取Fecify支持的26种可选语言列表(含编码和名称) docs/language/all-languages.md
4 店铺语言 /api/skill/addons-language/get-languages GET 获取当前店铺已启用的语言列表 docs/language/shop-languages.md
5 保存语言 /api/skill/addons-language/save-language POST 修改店铺启用语言(全量替换已有语言列表) docs/language/save-language.md
6 翻译语言列表 /api/skill/addons-language/get-translate-langs GET 获取翻译编辑时可选的源语言与目标语言列表(翻译流程第一步) docs/language/translate-langs.md

内容翻译 get/save 对

# 实体 get save 用途 文档
7-8 商品专辑 /api/skill/addons-language/get-collection-translate /api/skill/addons-language/save-collection-translate 获取/保存商品专辑的多语言翻译内容 docs/language/get-collection-translate.md / save
9-10 博客文章 /api/skill/addons-language/get-blog-article-translate /api/skill/addons-language/save-blog-article-translate 获取/保存博客文章的多语言翻译内容 docs/language/get-blog-article-translate.md / save
11-12 博客专辑 /api/skill/addons-language/get-blog-collection-translate /api/skill/addons-language/save-blog-collection-translate 获取/保存博客专辑的多语言翻译内容 docs/language/get-blog-collection-translate.md / save
13-14 自定义页面 /api/skill/addons-language/get-page-translate /api/skill/addons-language/save-page-translate 获取/保存自定义页面的多语言翻译内容 docs/language/get-page-translate.md / save
15-16 菜单子项 /api/skill/addons-language/get-menu-item-translate /api/skill/addons-language/save-menu-item-translate 获取/保存菜单项的多语言翻译内容 docs/language/get-menu-item-translate.md / save
17-18 首页 SEO /api/skill/addons-language/get-site-seo-translate /api/skill/addons-language/set-site-seo-translate 获取/设置首页SEO(title/keywords/description)的多语言内容 docs/language/get-site-seo-translate.md / save

商品翻译专用

# API 路径 方法 用途 文档
19 获取翻译数据 /api/skill/addons-language/get-product-translate GET 一次性获取商品的所有翻译数据(主体/body/SEO/option/item/meta共6组) docs/language/workflow-product-translate.md
20 保存主体翻译 /api/skill/addons-language/save-product-translate POST 保存商品主体的多语言翻译(title/subtitle/body_html/meta*等8字段) docs/language/workflow-product-translate.md
21 保存Option翻译 /api/skill/addons-language/save-option-translate POST 保存商品规格名称的多语言翻译 docs/language/workflow-product-translate.md
22 保存Item翻译 /api/skill/addons-language/save-option-item-translate POST 保存商品规格值的多语言翻译 docs/language/workflow-product-translate.md

21. 模版管理 API (Theme API) — 19 个

# API 路径 方法 用途 文档
1 系统模版列表 /api/skill/theme/get-addons-theme-list GET 检查系统中所有 new_* 开头的预置模版(系统自带主题) docs/theme/api/system-list.md
2 系统模版→店铺 /api/skill/theme/themes-add-to-shop POST 将系统预置模版添加到当前店铺(传theme_id) docs/theme/api/system-add-shop.md
3 模版中心列表 /api/skill/theme/get-center-theme-list GET 获取模版中心(云端)提供的所有可用模版列表 docs/theme/api/center-list.md
4 模版中心→店铺 /api/skill/theme/center-themes-add-to-shop POST 将模版中心的模版安装到当前店铺 docs/theme/api/center-add-shop.md
5 装修市场列表 /api/skill/theme/get-market-theme-list GET 获取装修市场(第三方设计)的模版列表 docs/theme/api/market-list.md
6 装修市场→店铺 /api/skill/theme/market-themes-add-to-shop POST 将装修市场的模版安装到当前店铺 docs/theme/api/market-add-theme.md
7 店铺模版列表 /api/skill/theme/shop-theme-list GET 获取当前店铺下所有模版列表(含当前主题/其他/草稿),获取theme_id docs/theme/api/shop-list.md
8 添加新模版 /api/skill/theme/shop-add-theme POST 在当前店铺新建一个空白模版(传入模版名称) docs/theme/api/shop-add-theme.md
9 复制模版 /api/skill/theme/shop-copy-theme POST 复制已有模版为新模版(传原theme_id + 新名称) docs/theme/api/shop-copy.md
10 删除模版 /api/skill/theme/shop-delete-theme POST 删除店镭下的指定模版(不可删除正在使用的主题) docs/theme/api/shop-delete.md
11 发布模版 /api/skill/theme/shop-publish-theme POST 将指定模版设为当前店铺主题(传theme_id) docs/theme/api/shop-publish.md
12 重命名模版 /api/skill/theme/shop-rename-theme POST 修改店铺内模版的名称(传theme_id + 新名称) docs/theme/api/shop-rename.md
13 文件树 /api/skill/theme/get-file-tree GET 获取指定模版的完整文件树结构(templates/sections/snippets/assets等) docs/theme/api/file-tree.md
14 读取文件 /api/skill/theme/get-file-content GET 读取任意模版文件的源码内容(传theme_id + file_path) docs/theme/api/file-content-get.md
15 保存文件 /api/skill/theme/save-file-content POST 保存/覆写任意模版文件的内容(传theme_id + file_path + content) docs/theme/api/file-content-save.md
16 删除文件 /api/skill/theme/delete-file POST 删除模版中的指定文件(传theme_id + file_path) docs/theme/api/file-delete.md
17 可添加section /api/skill/theme/get-section-type GET 获取当前模版中可添加的 section 类型列表(用于添加新 section) docs/theme/api/get-add-sections.md
18 页面类型 /api/skill/theme/get-page-type GET 获取可装修的页面类型列表(home/product/collection/page/blog等) docs/theme/api/page-type-select.md
19 字体管理 /api/skill/theme/font-manager GET 获取可用字体列表(系统内置字体+自定义上传字体) docs/theme/api/fonts.md

22. 汇总统计

模块 API 数量
商品 (Products) 11
商品专辑 (Collections) 13
自定义页面 (Page) 5
博客文章 (Blog Article) 6
博客专辑 (Blog Collection) 10
商品评论 (Product Review) 11
客户管理 (Customer) 10
订单管理 (Order) 24
优惠券管理 (Coupon) 11
菜单管理 (Menu) 6
系统物流 (Shipping) 11
系统税费 (Tax) 13
权限管理 (Permission) 13
数据统计 (Statistics) 7
系统任务 (Task) 5
URL 重定向 (URL Redirect) 6
系统配置 (System Settings) 20
店铺信息 (Shop Info) 9
图片管理 (Base Image) 3
多语言 (Language) 22
模版管理 API (Theme API) 19
总计 245
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-18 11:41:32

results matching ""

    No results matching ""