获得suning商品详情 API 返回值说明

49 阅读6分钟

微信图片_20240905113500.png

苏宁易购获得suning商品详情API的返回值包含了丰富的商品信息,以下是对其返回值的一个清晰说明:

一、基本信息

商品ID/店铺ID:num_iid(如0071553120/000000012386464054),这是商品或店铺的唯一标识符。 商品标题:title(如喜丞空气循环扇-FX-L11-落地式家用/全方位无死角循环空气/可添加香薰精油(粤超)),简要描述了商品的主要特性和用途。 价格信息: price:实际售价(在此示例中为null,可能表示没有直接的价格信息)。 total_price:总价(示例中为0)。 suggestive_price:建议售价(示例中为0)。 orginal_price:原价(示例中为null)。 库存信息: num:库存数量(如99)。 min_num:最小起售数量(示例中为0)。 商品链接:detail_url

二、图片信息

商品主图链接:pic_url(如//imgservice.suning.cn/uimg1/b2c/image/H3u-pFrwo5SWCT84xie12A.jpg_400w_400h_4e),用于展示商品的主视觉图像。

三、品牌与分类信息

品牌:brand(示例中为null)。 品牌ID:brandId(示例中为null)。 商品分类:crumbs,包含了商品从大类到小类的详细分类信息(如厨卫电器 生活电器 > 生活小家电 > 电风扇)。 四、其他信息

创建、修改、下架时间:created_time、modified_time、delist_time(示例中均为空)。 商品描述:desc,包含了商品的详细描述信息(示例中为HTML格式的文本)。 五、API用途

苏宁易购商品详情API接口不仅可以用于展示商品信息、优化用户体验,还支持购买决策、竞品分析和市场研究等。同时,它还可以帮助开发者和商家进行推广和营销,获取商品的宣传素材和营销信息。

suning.item_get

公共参数

请求地址: 

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:num_iid=0070134261/703410301

参数说明:num_iid:店铺ID/商品ID

响应参数

Version: Date:

名称类型必须示例值描述
num_iidBigint010228868562商品ID
titleString0百慕爱BAIMUAI休闲鞋 女2019春季 透气 时尚 推荐舒适增高运动鞋女板鞋女英伦小白鞋女学生磨砂皮女鞋商品标题
desc_shortString0秋冬新款 热销推荐商品简介
priceInt00价格
total_priceInt00
suggestive_priceInt00
orginal_priceInt00原价
nickString0卖家昵称
numInt099
min_numInt00
detail_urlString0product.suning.com/0070089297/…商品链接
pic_urlString0//imgservice.suning.cn/uimg1/b2c/image/9mYpQTuKpP6YfYQ0KEgafA.jpg_800w_800h_4e商品图片
brandString0品牌名称
brandIdString0品牌ID
rootCatIdString0顶级分类ID
cidString0
crumbsMix0{"0": "服装鞋帽", "340557": "女鞋", "501404": "女士帆布鞋"}导航列表
created_timeString0
modified_timeString0
delist_timeString0
descString0
desc_imgMix0["//uimgproxy.suning.cn/uimg1/sop/commodity/gsVgSK_aShsXbB2fgGg7fA.png"]商品描述图片
item_imgsMix0[//imgservice.suning.cn/uimg1/b2c/image/9mYpQTuKpP6YfYQ0KEgafA.jpg_800w_800h_4e]商品图片
item_weightString0
item_sizeString0
locationString0发货地
post_feeString0物流费用
express_feeString0快递费用
ems_feeString0EMS费用
shipping_toString0发货至
has_discountString0
videoMix0[]商品视频
is_virtualString0
sample_idString0商品风格标识ID
is_promotionString0
props_nameString0color-ex:08:颜色:白色;color-ex:09:颜色:黑色;buytype:16:尺码:35码商品属性名
prop_imgsMix0{"prop_img": []}商品属性图片列表
property_aliasString0color-ex:08:白色;buytype:16:35码商品属性别名
propsMix0[]商品详情
total_soldString0
skusMix0{"sku": [{"price": null, "orginal_price": "", "properties": "color-ex:08;buytype:16", "properties_name": "color-ex:08:颜色:白色;buytype:16:尺码:35码", "quantity": 0, "sku_id": 0 }] }商品规格信息
seller_idString0卖家ID
salesString0销量
shop_idString0店铺ID
props_listMix0{"color-ex:08": "颜色:白色","buytype:16": "尺码:35码"}商品属性
seller_infoMix0{"nick": "", "city": null, "level": "", "rate": "", "totle_pf": null, "desc_pf": null, "server_pf": null, "send_pf": null, "shop_type": "", "user_num_id": "", "shopid": "", "shopname": "", "shop_href": "shop.suning.com/", "tel": null, "menu": [] }卖家信息
tmallBoolean0是否天猫
errorString0错误信息
warningString0警告信息
url_logString0
soldInt00
props_imgMix0[]
shopinfoString0{"shop_name": ""}店铺信息
shop_itemMix0[]
relate_itemsMix0[]

API 接口测试指南 进行 API 接口测试时,以下是一些建议和最佳实践:

定义测试目标:明确测试的目的和范围,例如测试某个特定功能或评估整体性能。 了解 API 文档:熟悉 API 的文档,包括端点、请求 / 响应格式、参数和预期行为。 选择测试工具:使用专门的 API 测试工具,接口测试(点》击》免》费》注》册):测试 API 接口的可用性、稳定性等方面。 编写测试用例:根据 API 的功能和要求编写详细的测试用例,包括输入、预期输出和测试步骤。 自动化测试:尽可能自动化测试用例,以便在代码更改或新功能添加时快速运行测试。 模拟和断言:使用模拟数据来测试 API,并使用断言来验证 API 的响应是否符合预期。 错误处理和异常:确保测试包括错误处理和异常情况,如输入验证、身份验证失败等。 性能测试:对 API 进行负载测试和压力测试,以评估其在高并发场景下的性能。 安全性考虑:测试 API 的安全特性,如身份验证、授权、加密和防止 SQL 注入等。 持续集成 / 持续部署(CI/CD):将 API 测试集成到 CI/CD 流程中,以便在代码更改时自动运行测试。 测试报告和分析:生成详细的测试报告,分析测试结果,并与开发团队共享以改进 API。 通过遵循这些指南和最佳实践,您可以更有效地进行 API 接口测试,确保您的应用程序接口稳定、可靠且安全。