背景介绍
快手商城是快手平台上的一个电商购物频道，类似于淘宝、京东等商城，用户可以通过搜索或者快手 App 首页的一级入口进入。目前，快手商城正在招商中，今年双 11 期间，快手将力推短视频、直播间、店铺、商城这一全新的商家经营矩阵。
据了解，今年 8 月快手已经对商城频道进行了灰度测试，商城的入口位于快手 App 首页顶部的 Tab 栏。灰度测试的商城首页包含了商品分类栏以及品牌补贴、超级秒杀和品牌特卖等频道。测试过程中发现，快手商城页面访问用户中，超过 70% 不是在短视频、直播间购买过东西的用户。
API 列表
目前公司开发了关于快手商城商品的接口，分别是获取快手商品详情数据 API：item_get 和关键字搜索商品列表 API：item_search。
商品详情接口 item_get 是通过传入商品 id，获取到商品的详情数据信息，包括宝贝标题、商品简介、价格、掌柜昵称、库存、宝贝链接、宝贝图片、品牌名称、品牌 id、分类信息、商品详情、商品属性等。
有些人要问，那我去哪里获取到这些商品的商品 id 呢？通过关键字搜索接口可以获取到，item_search 获取传入关键字获取到这一类的商品 id 列表，支持翻页展示。
详细调用步骤
1、注册账号获取 APIkey & secret。
2、开通需要测试的 API 接口权限。
3、进入测试页测试。
4、正式对接代码，接入商城。
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用 key（必须以 GET 方式拼接在 URL 中） |
| secret | String | 是 | 调用密钥 |
| api_name | String | 是 | API 接口名称（包括在请求地址中）[item_search,item_get,item_search_shop 等] |
| cache | String | 否 | [yes,no] 默认 yes，将调用缓存的数据，速度比较快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export] 返回数据格式，默认为 json，jsonu 输出的内容中文可以直接阅读 |
| lang | String | 否 | [cn,en,ru] 翻译语言，默认 cn 简体中文 |
| version | String | 否 | API 版本 |
请求参数
请求参数：num_iid=79356974
参数说明：num_iid: 商品 ID ; delist_time 不为空代表商品已下架；数据会获取异常。
响应参数
Version: Date:2023-05-29
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | item[] | 1 | 商品详情数据 | |
| num_iid | Bigint | 1 | 20046611202546 | 商品 ID |
| title | String | 1 | 重磅 200 克男款休闲百搭【招财猫】纯棉短袖 T 恤 | 宝贝标题 |
| desc_short | String | 0 | 商品简介 | |
| price | Float | 1 | 11.93 | 价格 |
| total_price | Float | 0 | ||
| orginal_price | String | 0 | 11.93 | 原价 |
| suggestive_price | Float | 0 | ||
| nick | String | 1 | 达人丽丽教搭配 | 掌柜昵称 |
| num | Int | 0 | 0 | 库存 |
| min_num | Int | 0 | 0 | 最小购买数 |
| detail_url | String | 0 | https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20046611202546 | 宝贝链接 |
| pic_url | String | 1 | https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg | 宝贝图片 |
| brand | String | 0 | 其他 /other | 品牌名称 |
| brandId | Int | 0 | 品牌 ID | |
| rootCatId | Int | 0 | 顶级分类 ID | |
| cid | Int | 0 | 0 | |
| crumbs | Mix | 0 | [] | 导航菜单 |
| desc | String | 0 | https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-2fd76963ba6e41b4bb52982191a97daf.jpg | 商品详情 |
| desc_img | Mix | 0 | [] | 商品详情图片 |
| item_imgs | Mix | 0 | item_imgs[] | 商品图片 |
| props_name | String | 0 | 商品属性名 | |
| prop_imgs | prop_imgs[] | 0 | 商品属性图片列表 | |
| property_alias | String | 0 | 销售属性值别名 | |
| props | Mix | 0 | [{name: "品牌",value: "其他 /other"}] | 商品属性 |
| skus | skus[] | 0 | 商品规格信息列表 | |
| seller_id | Int | 0 | 407236546 | 卖家 ID |
| shop_id | Int | 0 | 407236546 | 店铺 ID |
| seller_info | seller_info[] | 0 | 卖家信息 | Array |
