获取基本信息

得到:基础-系统初始化信息

接口信息

  • 接口地址: {your-site-url}/api/skill/base/init
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取服务端后台的初始化配置信息,包括上架插件列表、支持的店铺类型、系统标题/Logo 及各类基础 URL 地址。

认证

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

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)

请求参数

无请求参数。

请求示例

cURL

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

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "enable_addons": [
            "blog",
            "currency",
            "language",
            "shopb2b",
            "siteseo",
            "sitemap",
            "..."
        ],
        "store": {
            "b2c": true,
            "b2b": true
        },
        "title": "服务端后台标题",
        "logo": "/common/0/image/2024/12/10/xxx.png",
        "base_image_url": "https://cdn.example.com",
        "base_url": "https://your-domain.com/admin",
        "api_base_url": "https://your-domain.com/admin/api",
        "public_url": "https://your-domain.com"
    },
    "message": "success"
}

返回字段说明

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

data 子字段

字段 类型 说明
enable_addons Array 上架的插件列表,列出所有可用的插件名称
store Object 支持的店铺类型及激活状态
title String 服务端后台的标题
logo String 服务端后台 Logo 图片的相对路径
base_image_url String 图片基础 URL,通过 base_image_url + 图片相对路径 可拼接得到图片完整访问地址
base_url String 服务端后台的基础 URL,用于浏览器访问服务端后台
api_base_url String 服务端后台 API 基础地址,用于浏览器访问系统时加载的 API(非 skill API)
public_url String 系统 JS、CSS 等静态资源文件的基础 URL

data.store 子字段

字段 类型 说明
b2c Boolean B2C 店铺是否激活可用,true 表示可用
b2b Boolean B2B 店铺是否激活可用,true 表示可用

注意事项

  1. base_image_url 的值取决于图片存储配置(本地服务器或第三方云存储),通过 base_image_url + 图片路径 即可拼接出完整图片 URL。
  2. api_base_url 是浏览器访问系统时加载的 API 地址,与 skill API 的认证和调用方式不同,不能直接用于 skill API 调用。
  3. enable_addons 列出了所有已上架的插件,可用于判断系统是否支持特定功能。
  4. store.b2cstore.b2b 分别控制对应店铺类型的创建权限,false 时无法创建该类型店铺。

results matching ""

    No results matching ""