get_goods_detail — 商品详情

获取单品完整信息:agent 可读规格、图片、售后规则。agent 转述给用户并对其承诺负责的字段都在这里。

何时用

向用户展示推荐理由、或下单前需要精确规格(尺寸/材质/适用/禁忌)时。

参数

参数 类型 必填 说明
sku_id string 是 商品 SKU 编码
merchant_id number 否 同名 SKU 多商家时区分

响应要点

示例

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 换推荐。