SuperAPI AI 工具集

channel3-api

数据与分析

查看项目

更新于 10-16 05:02

技能介绍

用途:Channel3 是通用商品目录 API,本技能指导开发者按输入类型选择合适端点完成商品搜索、推荐与详情查询。

主要能力与端点:文本/图片/图文搜索用 POST /v1/search;自然语言长描述可设 config.mode 为 agentic;相似推荐用 POST /v1/similar(需 Channel3 product_id);商品详情用 GET /v1/products/{id}(免费);商家 URL 解析用 POST /v1/lookup;仅筛选无查询用 POST /v1/browse;对话式购物用 POST /v1/conversations;点击与成交归因用 GET /v1/reporting/clicks 与 /v1/reporting/transactions;价格变动提醒用 POST /v0/price-tracking/start;类目 slug 搜索用 GET /v1/categories/search。颜色约束用 filters.colors(映射 sRGB hex),非颜色属性用 filters.attributes。

使用方式:Base URL 为 https://api.trychannel3.com,服务端用 x-api-key 头认证,浏览器端用短期 client token。安装:npm install @channel3/sdk 或 pip install channel3-sdk,另有 Go SDK。CLI 安装:npm install -g @channel3/cli。React UI 组件通过 npx shadcn@latest add https://ui.trychannel3.com/r/all.json 引入。

限制与注意:/v1/similar 不接受自由文本或图片;/v1/lookup 延迟约 2–10 秒且非商品页返回 422;locale 影响返回的商家报价,默认 en/US/USD;属性句柄与取值应以 categories.retrieve 为准,不要猜测。完整文档见 docs.trychannel3.com。