GEO-自定义页面-列表

接口信息

  • 接口地址: {your-site-url}/api/skill/geo/page-list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 分页获取自定义页面的 GEO 数据列表。

认证

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

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

请求参数

字段 类型 必填 说明
page_ids array[string] 否 自定义页面 ID 过滤。支持数组格式,也支持英文逗号隔开的 ID 字符串,如 343,324,54
pageNum int 否 页码,从 1 开始,缺省为 1
pageSize int 否 每页个数,缺省为 20
language_code string 否 GEO 语言代码,缺省为 en

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/geo/page-list?pageNum=1&pageSize=10' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 4,
                "shop_id": 359,
                "page_id": 112,
                "language_code": "en",
                "summary": null,
                "semantic_content": null,
                "page_type": "",
                "topic": "",
                "category_path": [],
                "key_topics": [],
                "key_facts": [],
                "benefits": [],
                "applications": [],
                "target_users": [],
                "user_questions": [],
                "solution_scenarios": [],
                "search_terms": [],
                "entities": [],
                "related_topics": [],
                "faq": [],
                "related_products": [],
                "related_collections": [],
                "commercial_info": [],
                "geo_score": "0.00",
                "source_content_hash": "",
                "created_at": "2026-08-20 00:23:20",
                "updated_at": "2026-08-20 00:23:20"
            }
        ],
        "total": 4,
        "pageSize": 1,
        "totalPage": 4
    },
    "message": "success"
}

返回字段说明

列表中每个元素为一条页面 GEO 数据,完整字段说明见 GEO-自定义页面-保存。

字段 类型 说明
code int 状态码,200 表示成功
message string 执行结果的文字描述
data object 分页数据
data.list array[object] 页面 GEO 列表
data.total int 总记录数
data.pageSize int 每页个数
data.totalPage int 总页数

注意事项

  1. page_ids 支持数组与逗号分隔字符串两种传法
  2. 一个页面只允许存在一份 GEO 数据(按 page_id 唯一)
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-08-23 16:17:25

results matching ""

    No results matching ""