SuperAPI AI 工具集

product-catalog-management

设计与创作

查看项目

更新于 10-15 21:11

技能介绍

用途:覆盖商品全生命周期,包括创建带定价模式的商品、管理附加项与集合、上传商品图片、向客户交付数字文件。

主要能力:商品支持三种定价模式,创建时选定其一——one_time_price(一次性)、recurring_price(按可配置频率与订阅周期)、usage_based_price(按用量,需先按 usage-based-billing 技能创建 meter)。定价嵌套在商品对象内,无独立顶层 Price 资源;价格对象含 type、currency(ISO 4217)、price(最小货币单位,如美分)、可选 discount。创建时必须提供 tax_category,支持 digital_products、saas、e_book、edtech。商品支持 list、retrieve、update、archive/unarchive,无删除接口。还可创建附加项、商品集合(含分组与条目)、商品短链,并通过 entitlements 交付数字文件。

使用方式:以 Node SDK 为例,初始化 client 后调用 client.products.create 创建商品,传入 name、tax_category 与 price;recurring 需指定 payment_frequency_count/interval 与 subscription_period_count/interval;usage_based 通过 price.meters 数组附加 meter_id、price_per_unit(最小单位小数字符串)与可选 free_threshold。图片经预签名 URL 上传,URL 60 秒内有效,需立即 PUT。集合结账时 product_cart 必须传空数组。数字交付的下载链接约 15 分钟有效。

适用场景:搭建商品目录或店铺、管理变体与附加项、上传图片、交付数字文件、排查商品更新或定价修改失败原因。

限制:商品创建后不能更改定价模式或价格,需新建商品;无删除接口,只能归档;客户端不应硬编码价格,应通过 API 获取;purchasing_power_parity 字段在示例中出现但标记为不可用,地区与货币定价应使用 localized-pricing 技能。具体收费与价格信息暂未提供。