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

简介: -- 请求示例 url 默认请求参数已经URL编码处理curl -i "https://api-gw.onebound.cn/ks/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=79356974"

 item_get-根据ID取商品详情 注册开通

ks.item_get

公共参数

名称 类型 必须 描述
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 商品详情数据

请求示例

 

-- 请求示例 url 默认请求参数已经URL编码处理

curl -i "https://api-gw.onebound.cn/ks/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=79356974"

响应示例

{

       "item": {

           "num_iid": "20046611202546",

           "title": "重磅200克男款休闲百搭【招财猫】纯棉短袖T恤",

           "desc_short": "",

           "price": 19.9,

           "total_price": 0,

           "suggestive_price": 0,

           "orginal_price": 0,

           "nick": "达人丽丽教搭配",

           "num": 0,

           "min_num": 0,

           "detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20046611202546",

           "pic_url": "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg",

           "brand": "其他/other",

           "brandId": null,

           "rootCatId": 0,

           "cid": 0,

           "crumbs": [],

           "created_time": "",

           "modified_time": "",

           "delist_time": "",

           "desc": [

               "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-2fd76963ba6e41b4bb52982191a97daf.jpg",

               "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-56e029ac29624b3bb984bc11730bfe12.jpg",

           ],

           "desc_img": [],

           "item_imgs": [

               {

                   "url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg"

               },

               {

                   "url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-68b7ad1802a9475e929adad9efe06bf2.jpg"

               }

           ],

           "item_weight": "",

           "item_size": "",

           "location": "",

           "post_fee": "",

           "express_fee": "",

           "ems_fee": "",

           "shipping_to": "",

           "has_discount": "",

           "video": [],

           "is_virtual": "",

           "sample_id": "",

           "is_promotion": "",

           "props_name": null,

           "prop_imgs": {

               "prop_img": []

           },

           "property_alias": "",

           "props": [

               {

                   "name": "品牌",

                   "value": "其他/other"

               },

               {

                   "name": "主材质",

                   "value": "棉"

               }

           ],

           "total_sold": "",

           "skus": {

               "sku": [

                   {

                       "price": 19.9,

                       "total_price": 0,

                       "orginal_price": 0,

                       "properties": "20601742184:20601742196",

                       "properties_name": "20601742184:20601742196:白色:4XL 170-185斤;",

                       "quantity": 679,

                       "sku_id": 70581398202546

                   },

                   {

                       "price": 19.9,

                       "total_price": 0,

                       "orginal_price": 0,

                       "properties": "20601742184:20601742197",

                       "properties_name": "20601742184:20601742197:白色:5XL 185-200斤;",

                       "quantity": 685,

                       "sku_id": 70581398203546

                   }

               ]

           },

           "seller_id": 407236546,

           "sales": "311",

           "shop_id": 407236546,

           "props_list": [],

           "seller_info": {

               "nick": "达人丽丽教搭配",

               "shop_type": null,

               "user_num_id": 407236546,

               "sid": 407236546,

               "title": "达人丽丽教搭配",

               "zhuy": "https://app.kwaixiaodian.com/page/kwaishop-c-shoplist?layoutType=4&enableWK=1&id=407236546",

               "shop_name": "达人丽丽教搭配"

           },

           "tmall": "false",

           "warning": "",

           "url_log": [],

           "shop_name": "达人丽丽教搭配",

           "_ddf": "jf",

           "props_img": [],

           "format_check": "fail"

       },

       "error": "",

       "translate_status": "",

       "translate_time": 0,

       "language": {

           "default_lang": "cn",

           "current_lang": "cn"

       },

       "reason": "",

       "error_code": "0000",

       "cache": 0,

       "api_info": "today:5 max:30000 all[7=5+0+2];expires:2024-05-20",

       "execution_time": "0.579",

       "server_time": "Beijing/2023-05-29 11:21:26",

       "client_ip": "106.6.37.94",

       "call_args": {

           "num_iid": "20046611202546"

       },

       "api_type": "ks",

       "translate_language": "zh-CN",

       "translate_engine": "baidu",

       "server_memory": "3.08MB",

       "request_id": "1.64741a35a4d99",

       "last_id": "1770033004"}

异常示例

{

           "error": "item-not-found",

           "reason": "商品没找到",

           "error_code": "2000",

           "success": 0,

           "cache": 0,

           "api_info": "today:0 max:10000",

           "execution_time": 0.081,

           "server_time": "Beijing/2020-06-10 23:44:00",

           "call_args": [],

           "api_type": "ks",

           "request_id": "20046611202546"}

   }

相关资料

错误码解释

状态代码(error_code) 状态信息 详细描述 是否收费
0000 success 接口调用成功并返回相关数据
2000 Search success but no result 接口访问成功,但是搜索没有结果
4000 Server internal error 服务器内部错误
4001 Network error 网络错误
4002 Target server error 目标服务器错误
4003 Param error 用户输入参数错误 忽略
4004 Account not found 用户帐号不存在 忽略
4005 Invalid authentication credentials 授权失败 忽略
4006 API stopped 您的当前API已停用 忽略
4007 Account stopped 您的账户已停用 忽略
4008 API rate limit exceeded 并发已达上限 忽略
4009 API maintenance API维护中 忽略
4010 API not found with these values API不存在 忽略
4012 Please add api first 请先添加api 忽略
4013 Number of calls exceeded 调用次数超限 忽略
4014 Missing url param 参数缺失 忽略
4015 Wrong pageToken 参数pageToken有误 忽略
4016 Insufficient balance 余额不足 忽略
4017 timeout error 请求超时
5000 unknown error 未知错误
相关文章
|
3天前
|
算法 Java API
如何使用Java开发获得淘宝商品描述API接口?
本文详细介绍如何使用Java开发调用淘宝商品描述API接口,涵盖从注册淘宝开放平台账号、阅读平台规则、创建应用并申请接口权限,到安装开发工具、配置开发环境、获取访问令牌,以及具体的Java代码实现和注意事项。通过遵循这些步骤,开发者可以高效地获取商品详情、描述及图片等信息,为项目和业务增添价值。
32 10
|
3天前
|
存储 API 数据库
使用Python开发获取商品销量详情API接口
本文介绍了使用Python开发获取商品销量详情的API接口方法,涵盖API接口概述、技术选型(Flask与FastAPI)、环境准备、API接口创建及调用淘宝开放平台API等内容。通过示例代码,详细说明了如何构建和调用API,以及开发过程中需要注意的事项,如数据库连接、API权限、错误处理、安全性和性能优化等。
32 5
|
2天前
|
数据可视化 搜索推荐 API
速卖通获得aliexpress商品详情API接口的开发、应用与收益。
速卖通(AliExpress)作为阿里巴巴旗下的跨境电商平台,为全球消费者提供丰富商品。其开放平台提供的API接口支持开发者获取商品详情等信息,本文探讨了速卖通商品详情API的开发流程、应用场景及潜在收益,包括提高运营效率、降低成本、增加收入和提升竞争力等方面。
13 1
|
9天前
|
JSON API 数据格式
获取商品详情API的请求格式是什么
获取商品详情API的请求格式通常依赖于特定的电商平台或服务提供商,但一般遵循类似的结构。以下是一个概括性的说明,以及针对几个主流电商平台的示例:
|
8天前
|
供应链 监控 搜索推荐
获得1688商品评论API接口的开发应用与收益
1688商品评论API接口提供丰富的商品评论数据,涵盖评论内容、用户信息、商品评分等,助力电商平台优化运营、市场分析和供应链管理,提升客户满意度与忠诚度,促进商业价值增长。
21 3
|
9天前
|
搜索推荐 API 开发者
虾皮根据关键词取商品列表API接口的开发应用与收益
虾皮根据关键词取商品列表API接口的开发与应用为电商数据分析与应用提供了强大的支持。通过这一接口,开发者可以快速获取商品信息,实现精准营销、市场趋势分析、商品推荐等多种应用。同时,这一接口也为电商平台带来了提升用户体验、增加用户流量、提高运营效率等多重收益。随着电商行业的不断发展,虾皮的API接口将在未来发挥更加重要的作用,推动电商行业的数字化转型和智能化发展。
20 2
|
10天前
|
API Python
利用python淘宝/天猫获得淘宝app商品详情原数据 API
要使用Python获取淘宝/天猫商品详情原数据,需先注册开放平台账号并实名认证,创建应用获取API权限。随后,根据API文档构建请求URL和参数,使用requests库发送请求,处理返回的商品详情数据。注意遵守平台使用规则。
|
13天前
|
API 数据安全/隐私保护 开发者
实时获取小红书详情 API 数据
小红书详情API数据获取指南:注册开发者账号,创建应用并申请接口权限,构建请求获取笔记详情,使用Python等语言处理响应数据。需遵守使用规则,注意调用频率和数据安全。
|
10天前
|
JSON 缓存 监控
淘宝商品详情接口(Taobao.item_get)丨淘宝API接口指南
淘宝商品详情接口(Taobao.item_get)允许开发者通过HTTP GET方法获取淘宝商品的详细信息,包括商品ID、价格、库存等。请求需包含key、secret、num_iid等必选参数,支持缓存及多种返回格式。此接口广泛应用于电商数据分析、商品选品、价格监控等领域,提升商家运营效率。
|
13天前
|
供应链 API 开发者
探索Python与1688商品详情API接口的协同效应
在数字化时代,1688作为中国领先的B2B平台,其商品详情API接口为市场分析、库存管理和销售策略提供了重要数据支持。本文介绍如何使用Python调用该API,包括前期准备、技术实现、数据解析及错误处理等内容,助力企业和开发者挖掘数据价值,提升商业智能水平。