get_goods_detail — 商品详情
获取单品完整信息:agent 可读规格、图片、售后规则。agent 转述给用户并对其承诺负责的字段都在这里。
何时用
向用户展示推荐理由、或下单前需要精确规格(尺寸/材质/适用/禁忌)时。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sku_id | string | 是 | 商品 SKU 编码 |
| merchant_id | number | 否 | 同名 SKU 多商家时区分 |
响应要点
agent_desc:为 AI 助手编写的确定性规格——可直接向用户转述,平台对其准确性负责aftersale_rules:7 天无理由 / 免费取件配额说明retail_price(分)、free_ship_threshold(包邮门槛)
示例
curl
curl "https://api.yuantoutao.com/v1/goods/MOCKSKU2_3" \
-H "Authorization: Bearer ak_你的key"
node
const d = await (await fetch(`https://api.yuantoutao.com/v1/goods/${skuId}`, {
headers: { Authorization: `Bearer ${KEY}` }
})).json();
python
d = requests.get(f'https://api.yuantoutao.com/v1/goods/{sku_id}',
headers={'Authorization': f'Bearer {KEY}'}).json()
常见错误
ORDER_NOT_FOUND(404)= 商品已下架或编码错误——重新 search_goods 换推荐。