GEO-博客文章-详细

接口信息

  • 接口地址: {your-site-url}/api/skill/geo/article-info
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 获取单个博客文章的 GEO 数据详情。

认证

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

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

请求参数

字段 类型 必填 说明
article_id int 是 博客文章 ID
language_code string 否 GEO 语言代码,缺省为 en

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/geo/article-info?article_id=620' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "id": 5,
        "shop_id": 359,
        "article_id": 620,
        "language_code": "en",
        "summary": "This article explains how to choose a suitable camping tent based on outdoor usage scenarios.",
        "semantic_content": "This article is a camping tent selection guide that helps users evaluate different tent options before purchase.",
        "article_type": "Buying Guide",
        "topic": "Camping Tent Selection Guide",
        "category_path": ["Sports & Outdoors", "Outdoor Recreation", "Camping & Hiking", "Camping Equipment Selection"],
        "key_topics": ["Camping tent selection", "Tent size and capacity"],
        "key_points": ["The suitable tent size depends on the number of users."],
        "key_facts": [{"fact": "Tent selection should consider the number of people.", "source": "Article content"}],
        "definitions": [{"term": "Camping Tent", "definition": "A temporary shelter designed for outdoor activities."}],
        "user_questions": ["How do I choose the right camping tent?"],
        "solution_scenarios": ["Users preparing for camping trips"],
        "target_users": ["Beginner campers", "Outdoor enthusiasts"],
        "steps": [{"step": 1, "description": "Identify the camping scenario."}],
        "decision_factors": [{"factor": "Capacity", "description": "Choose a tent size according to the number of users."}],
        "comparison_dimensions": ["Size", "Capacity", "Material"],
        "limitations": ["The article provides general selection guidance."],
        "prerequisites": ["Users should understand their intended camping environment."],
        "related_products": [{"type": "Product Category", "name": "Camping Tents"}],
        "related_collections": [{"type": "Collection", "name": "Camping Equipment"}],
        "related_articles": [{"relationship": "follow_up", "topic": "Camping Equipment Checklist"}],
        "entities": [{"type": "Product Category", "name": "Camping Tent"}],
        "search_terms": ["how to choose a camping tent"],
        "faq": [{"question": "What should I consider when choosing a camping tent?", "answer": "Users should consider camping environment, tent capacity, material, portability."}],
        "geo_score": "93.50",
        "source_content_hash": "a7c92d8f3e5b1a9c7d4e8f6a2b3c5d7e",
        "created_at": "2026-08-20 10:19:52",
        "updated_at": "2026-08-20 18:50:22"
    },
    "message": "success"
}

返回字段说明

返回字段即博客文章 GEO 数据字段,完整字段说明见 GEO-博客文章-保存。

字段 类型 说明
code int 状态码,200 表示成功
message string 执行结果的文字描述
data object 博客文章 GEO 数据
data.id int GEO 数据 ID(主键)
data.article_id int 博客文章 ID
data.language_code string GEO 语言代码
data.geo_score number GEO 数据完整度评分(0-100)
data.source_content_hash string 生成 GEO 时文章源数据的内容 hash
data.created_at string 创建时间
data.updated_at string 更新时间

注意事项

  1. article_id 为必填,缺失时接口返回错误
  2. 该文章的 GEO 数据不存在时返回 data 为 null

  3. article_id 缺失时接口返回错误(code 非 200,message 为空)

Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-08-23 16:17:24

results matching ""

    No results matching ""