Fecify系统版本信息

基础-获取升级信息

接口信息

  • 接口地址: {your-site-url}/api/skill/base/get-upgrade-info
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取当前系统的版本升级信息和授权状态。授权正常时额外返回插件列表和版本日志。

认证

请求头中需要携带 skill-access-token：

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数

无请求参数。

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/base/get-upgrade-info' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

返回结果根据授权状态不同而有所差异：

授权过期时的响应

{
    "code": 200,
    "data": {
        "current_version": "6.2.0",
        "is_need_upgrade": false,
        "uninstallAddons": "",
        "info": {
            "result_code": 1027010012,
            "result_mess": "域名domain不存在"
        }
    },
    "message": "success"
}

授权正常时的响应

{
    "code": 200,
    "data": {
        "current_version": "6.2.0",
        "is_need_upgrade": false,
        "uninstallAddons": "",
        "info": {
            "top_version": "6.2.0",
            "addons": [
                "shopb2b",
                "shopb2c",
                "blog",
                "currency",
                "language",
                "..."
            ],
            "history_versions": [
                {
                    "version": "6.2.0",
                    "version_info": [
                        {
                            "type": "新增",
                            "tip": "add",
                            "content": "功能描述"
                        }
                    ],
                    "created_at": "2026-06-02 20:41:08"
                }
            ],
            "result_code": 200,
            "result_mess": "success"
        }
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Object 返回数据

data 子字段

字段 类型 说明
current_version String 当前系统版本号
is_need_upgrade Boolean 是否需要升级，true 表示有新版本可升级
uninstallAddons String 未安装的插件信息，为空字符串表示所有可用插件均已安装
data.info Object 授权检测结果

data.info 子字段（通用）

字段 类型 说明
result_code Number 授权结果编码：200 为正常，其他值为异常
result_mess String 授权结果信息，异常时显示异常描述

data.info 子字段（仅授权正常时返回）

字段 类型 说明
top_version String 最新可用版本号
addons Array 授权的插件列表
history_versions Array 版本日志信息

data.info.history_versions 子字段

字段 类型 说明
version String 版本号
version_info Array 该版本的功能变更记录
version_info[].type String 变更类型（如 "新增"、"优化"、"修复"）
version_info[].tip String 变更标签（add = 新增，update = 优化，bug = 修复）
version_info[].content String 变更内容描述
created_at String 该版本的发布时间（格式：YYYY-MM-DD HH:mm:ss）

注意事项

  1. 授权过期时 info 仅返回 result_code 和 result_mess，不包含 addons 和 history_versions。
  2. is_need_upgrade 为 true 时表示官方发布了更新版本，可通过升级操作更新系统。
  3. history_versions 按版本倒序排列，最新版本排在前面。

results matching ""

    No results matching ""