GEO-商品专辑-详细

接口信息

  • 接口地址: {your-site-url}/api/skill/geo/collection-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)

请求参数

字段 类型 必填 说明
collection_id int 是 商品专辑 ID
language_code string 否 GEO 语言代码,缺省为 en

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/geo/collection-info?collection_id=20002' \
--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,
        "collection_id": 20002,
        "language_code": "en",
        "summary": "A collection of outdoor camping tents designed for different outdoor activities.",
        "collection_type": "Camping Tents",
        "category_path": ["Outdoor Equipment", "Camping Gear", "Shelters", "Camping Tents"],
        "key_features": ["Various tent sizes and capacities"],
        "product_types": ["Family Camping Tents", "Portable Camping Tents"],
        "comparison_dimensions": ["Size", "Capacity", "Material"],
        "search_terms": ["camping tents", "outdoor shelter"],
        "geo_score": "88.50",
        "source_content_hash": "6a8f3d9c2b1e4f7a9d8c5b6e3f2a1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a",
        "created_at": "2026-08-20 22:02:52",
        "updated_at": "2026-08-20 22:02:52"
    },
    "message": "success"
}

返回字段说明

返回字段即商品专辑 GEO 数据字段,完整字段说明见 GEO-商品专辑-保存。

字段 类型 说明
code int 状态码,200 表示成功
message string 执行结果的文字描述
data object 商品专辑 GEO 数据
data.id int GEO 数据 ID(主键)
data.collection_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. collection_id 为必填,缺失时接口返回错误
  2. 该专辑的 GEO 数据不存在时返回 data 为 null

  3. collection_id 缺失时返回错误码 100702003(collection id empty)

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

results matching ""

    No results matching ""