【快手API】根据ID取商品详情 API 返回值说明

客官°小女子只卖身不卖艺 2024-03-16 12:29 11阅读 0赞

### item\_get-根据ID取商品详情 ###

#### **开发背景：** ####

快手是一家中国领先的短视频社交平台，拥有亿级用户规模。为了提升快手平台的商业化能力，快手推出了“快手电商”服务，让商家可以在快手平台上开店、卖货，以及通过快手直播等方式与用户进行互动。而商品详情页是电商平台中非常重要的一部分，能直接影响用户购买意愿，因此需要开发一个快手商品详情API来提供商品数据支持，从而提升用户体验和商家的销售效率。该API可以让快手电商平台上的店铺、产品等信息可以被快速、准确地展示给用户，帮助用户更好地了解、选择商品，提高用户购买转化率和商家的营业额。

公共参数

请求地址: [https://o0b.cn/jennif][https_o0b.cn_jennif]

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>key</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用key（必须以GET方式拼接在URL中）</td> 
  </tr> 
  <tr> 
   <td>secret</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用密钥</td> 
  </tr> 
  <tr> 
   <td>api_name</td> 
   <td>String</td> 
   <td>是</td> 
   <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
  </tr> 
  <tr> 
   <td>result_type</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
  </tr> 
  <tr> 
   <td>lang</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>String</td> 
   <td>否</td> 
   <td>API版本</td> 
  </tr> 
 </tbody> 
</table>

请求参数

请求参数：num\_iid=79356974

参数说明：num\_iid:商品ID ; delist\_time不为空代表商品已下架;数据会获取异常。

响应参数

Version: Date:2023-05-29

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>示例值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> <p>item</p> </td> 
   <td>item[]</td> 
   <td>1</td> 
   <td></td> 
   <td>商品详情数据</td> 
  </tr> 
  <tr> 
   <td> <p>num_iid</p> </td> 
   <td>Bigint</td> 
   <td>1</td> 
   <td>20046611202546</td> 
   <td>商品ID</td> 
  </tr> 
  <tr> 
   <td> <p>title</p> </td> 
   <td>String</td> 
   <td>1</td> 
   <td>重磅200克男款休闲百搭【招财猫】纯棉短袖T恤</td> 
   <td>宝贝标题</td> 
  </tr> 
  <tr> 
   <td> <p>desc_short</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>商品简介</td> 
  </tr> 
  <tr> 
   <td> <p>price</p> </td> 
   <td>Float</td> 
   <td>1</td> 
   <td>11.93</td> 
   <td>价格</td> 
  </tr> 
  <tr> 
   <td> <p>total_price</p> </td> 
   <td>Float</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>orginal_price</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>11.93</td> 
   <td>原价</td> 
  </tr> 
  <tr> 
   <td> <p>suggestive_price</p> </td> 
   <td>Float</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>nick</p> </td> 
   <td>String</td> 
   <td>1</td> 
   <td>达人丽丽教搭配</td> 
   <td>掌柜昵称</td> 
  </tr> 
  <tr> 
   <td> <p>num</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td>库存</td> 
  </tr> 
  <tr> 
   <td> <p>min_num</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td>最小购买数</td> 
  </tr> 
  <tr> 
   <td> <p>detail_url</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20046611202546</td> 
   <td>宝贝链接</td> 
  </tr> 
  <tr> 
   <td> <p>pic_url</p> </td> 
   <td>String</td> 
   <td>1</td> 
   <td>https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg</td> 
   <td>宝贝图片</td> 
  </tr> 
  <tr> 
   <td> <p>brand</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>其他/other</td> 
   <td>品牌名称</td> 
  </tr> 
  <tr> 
   <td> <p>brandId</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td></td> 
   <td>品牌ID</td> 
  </tr> 
  <tr> 
   <td> <p>rootCatId</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td></td> 
   <td>顶级分类ID</td> 
  </tr> 
  <tr> 
   <td> <p>cid</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>crumbs</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td>导航菜单</td> 
  </tr> 
  <tr> 
   <td> <p>desc</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-2fd76963ba6e41b4bb52982191a97daf.jpg</td> 
   <td>商品详情</td> 
  </tr> 
  <tr> 
   <td> <p>desc_img</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td>商品详情图片</td> 
  </tr> 
  <tr> 
   <td> <p>item_imgs</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>item_imgs[]</td> 
   <td>商品图片</td> 
  </tr> 
  <tr> 
   <td> <p>props_name</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>商品属性名</td> 
  </tr> 
  <tr> 
   <td> <p>prop_imgs</p> </td> 
   <td>prop_imgs[]</td> 
   <td>0</td> 
   <td></td> 
   <td>商品属性图片列表</td> 
  </tr> 
  <tr> 
   <td> <p>property_alias</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>销售属性值别名</td> 
  </tr> 
  <tr> 
   <td> <p>props</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[{name: "品牌",value: "其他/other"}]</td> 
   <td>商品属性</td> 
  </tr> 
  <tr> 
   <td> <p>skus</p> </td> 
   <td>skus[]</td> 
   <td>0</td> 
   <td></td> 
   <td>商品规格信息列表</td> 
  </tr> 
  <tr> 
   <td> <p>seller_id</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>407236546</td> 
   <td>卖家ID</td> 
  </tr> 
  <tr> 
   <td> <p>shop_id</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>407236546</td> 
   <td>店铺ID</td> 
  </tr> 
  <tr> 
   <td> <p>seller_info</p> </td> 
   <td>seller_info[]</td> 
   <td>0</td> 
   <td>卖家信息</td> 
   <td>Array</td> 
  </tr> 
 </tbody> 
</table>

请求示例

\-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-服务器地址.cn/ks/item\_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num\_iid=79356974"

[https_o0b.cn_jennif]: https://o0b.cn/jennif