\r \r

bee-products-read\r

\r

版本: 2.0.0\r \r

简介\r

\r 通过小蜜蜂（Bee）建站开放 API 获取产品/商品列表数据。\r \r 支持按语言筛选、产品分组筛选（叶子节点）、分页查询，并返回完整产品结构数据，可用于商品展示、SEO 优化、数据分析与内容生成。\r \r ---\r \r

输入参数\r

\r

api_key (string, 必填)\r

\r API 身份认证密钥，用于标识调用方身份并控制接口访问权限。\r \r

• 获取地址: https://open.tradew.com\r
• 用于 API 权限校验\r \r ---\r \r

language (string, 必填)\r

\r 站点语言筛选参数。\r \r

⚠️ 必须从 bee-languages-get 返回列表中人工选择，不允许 AI 推断或自动生成。\r \r ---\r \r

productsgroup_id (integer, 可选)\r

\r 产品分组 ID。\r \r

⚠️ 仅允许选择 is_leaf === true 的叶子节点分组 \r 非叶子节点必须过滤，不可使用\r \r ---\r \r

pagination (object, 必填)\r

\r 分页配置参数。\r \r

current_page (integer)\r

\r

• 默认值: 1\r
• 最小值: 1\r
• 分页规则：\r
  • 必须依赖 data.pagination.has_next_page\r
  • 使用 data.pagination.next_page 作为下一页页码\r
  • 禁止基于 total_page 或手动递增推算\r
  • has_next_page=false 时必须停止请求\r \r ---\r \r

page_size (integer)\r

\r

• 默认值: 10\r
• 范围: 10 - 50\r \r ---\r \r

输出结构\r

\r

顶层结构\r

\r | 字段 | 类型 | 说明 |\r |--------|---------------|--------------------------|\r | status | boolean | 请求状态 |\r | msg | string | 返回消息 |\r | data | object/null | 返回数据 |\r \r ---\r \r

data.pagination\r

\r | 字段 | 类型 | 说明 |\r |----------------|-----------------|----------------|\r | current_page | integer | 当前页码 |\r | page_size | integer | 每页数量 |\r | total_page | integer | 总页数 |\r | total_count | integer | 总记录数 |\r | has_next_page | boolean | 是否存在下一页 |\r | next_page | integer/null | 下一页页码 |\r \r ---\r \r

data.list[]\r

\r 产品数据列表。\r \r | 字段 | 类型 | 说明 |\r |-----------------|------------------|--------------------------|\r | products_id | integer | 产品ID |\r | language | string | 站点语言 |\r | group | object | 产品分组 |\r | product_name | string | 产品名称 |\r | model | string | 产品型号 |\r | images | array | 产品图片URL列表 |\r | tags | array | 关键词 |\r | attributes | array | 属性列表 |\r | brief_description | string | 简要描述 |\r | description | string | 详情描述（HTML） |\r | tdk | object | SEO信息 |\r | view_count | integer | 访问量 |\r | inquiry_count | integer | 询盘量 |\r | product_url | string | 详情页URL |\r | create_time | string(datetime) | 创建时间 |\r | update_time | string(datetime) | 更新时间 |\r \r ---\r \r

group\r

\r | 字段 | 类型 | 说明 |\r |--------------------|--------|------------|\r | productsgroup_id | string | 分组ID |\r | group_name | string | 分组名称 |\r \r ---\r \r

attributes[]\r

\r | 字段 | 类型 | 说明 |\r |-------|--------|----------|\r | name | string | 属性名 |\r | value | string | 属性值 |\r \r ---\r \r

tdk\r

\r | 字段 | 类型 | 说明 |\r |-------------|--------|--------------------------|\r | title | string | SEO标题（≤70字符） |\r | description | string | SEO描述（25-160字符） |\r | keywords | string | SEO关键词（≤100字符） |\r \r ---\r \r

依赖关系\r

\r | 参数 | 依赖技能 | 字段来源 | 模式 |\r |------------------|------------------------|-----------------------|--------|\r | language | bee-languages-get | list[].language | select |\r | productsgroup_id | bee-productsgroup-read | list[].productsgroup_id | select（filter: is_leaf=true） |\r \r ---\r \r

使用示例\r

\r

基础查询\r

\r

{\r
  "api_key": "your-api-key",\r
  "language": "en",\r
  "pagination": {\r
    "current_page": 1,\r
    "page_size": 10\r
  }\r
}