Fecify-店铺导航-获取
店铺导航-获取配置
接口信息
- 接口地址:
{your-site-url}/api/skill/system-setting/link-get - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址,如https://your-domain.com/admin - 请求方式:
GET - Content-Type:
application/json - 配对接口: Fecify-店铺导航-保存
- 使用流程: 先调用本接口获取当前配置 → 修改
quick_links数组 → 调用保存接口提交 - 说明: 获取店铺导航快捷链接配置,该配置会在站点下所有店铺首页(商家端后台右上角)展示,支持外部链接跳转。
认证
请求头中需要携带 skill-access-token:
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
无请求参数。
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/system-setting/link-get' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'
返回结果
code 为 200 表示调用成功;code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"quick_links": [
{
"text": "官方网站",
"url": "https://www.fecify.com/?shop_id={shop_id}&access_token={access_token}"
},
{
"text": "应用市场",
"url": "https://www.fecify.com/addons.html"
},
{
"text": "刷新缓存",
"url": "{shop_base_url}/setting/cache/refresh"
}
]
},
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码,200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Object | 返回数据 |
data 子字段
| 字段 | 类型 | 说明 |
|---|---|---|
quick_links |
Array | 快捷链接列表,每个子项为一个锚文本链接对象 |
quick_links 子项
| 字段 | 类型 | 说明 |
|---|---|---|
text |
String | 锚文本文字,显示在商家端后台右上角 |
url |
String | 锚文本链接地址,点击后跳转到该 URL,支持外部链接 |
注意事项
quick_links中的每个子项会在商家端后台右上角固定显示,作为快捷导航入口。url支持外部链接(如https://开头)和内部相对链接,内部链接中可使用{shop_base_url}等动态变量。- 修改配置前先调用本接口获取当前值,编辑后通过 Fecify-店铺导航-保存 提交。