一、接口概述
唯品会商品详情API接口允许开发者通过发送请求,获取唯品会上特定商品的详细信息。这些信息包括商品标题、价格、库存、图片、描述等,对于商家来说,有助于更全面地展示商品;对于用户来说,则能够更深入地了解商品,从而做出更明智的购买决策。
二、接口调用流程
-
注册与认证:首先,开发者需要在唯品会开放平台注册账号并完成实名认证,获取API调用权限。
-
获取API密钥:在开放平台创建应用,并为应用申请API密钥。这个密钥是调用商品详情API的必要凭证。
-
构建请求:根据唯品会商品详情API接口的文档,构建请求。请求中需要包含API密钥和商品ID等关键信息。
唯品会获得vip商品详情 API 返回值说明
请求参数
请求参数:num_iid=1710613157-6918711233889249157
参数说明:num_iid:店铺ID-商品ID
---------------------------------------
Result Object:
---------------------------------------
{
"item": {
"num_iid": "1710613157-6918711233889249157",
"title": "【清凉运动】森马夏季新款复古运动风男式休闲中裤短裤男",
"desc_short": "",
"price": "35.00",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "159.00",
"nick": "",
"num": 0,
"min_num": 0,
"detail_url": "https://detail.vip.com/detail-1710613157-6918711233889249157.html",
"pic_url": "https://a.vpimg2.com/upload/merchandise/pdcvis/104218/2020/0814/160/7932992b-c2f6-4ed2-a97b-69824fa7ba10.jpg",
"brand": "森马",
"brandId": 1710613157,
"rootCatId": "",
"cid": 390576,
"crumbs": [],
"created_time": 1537845115000,
"modified_time": 1683886534000,
"delist_time": 2145888000000,
"desc": "<img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/1540464613-651972905622466560-651972905622466562-601.jpg\"><img src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2056028139-651972905622466560-651972905622466562-602.jpg\"><img src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2103507544-651972905622466560-651972905622466562-603.jpg\"><img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/805209464-651972905622466560-651972905622466562-604.jpg\"><img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/965265007-651972905622466560-651972905622466562-605.jpg\"><img src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/1456204603-651972905622466560-651972905622466562-606.jpg\"><img src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/245784564-651972905622466560-651972905622466562-607.jpg\"><img src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/478942397-651972905622466560-651972905622466562-608.jpg\"><img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/563202406-651972905622466560-651972905622466562-609.jpg\"><img src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/576808585-651972905622466560-651972905622466562-610.jpg\"><img src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/492548576-651972905622466560-651972905622466562-611.jpg\"><img src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/475079584-651972905622466560-651972905622466562-612.jpg\"><img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/643984351-651972905622466560-651972905622466562-613.jpg\"><img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/723627373-651972905622466560-651972905622466562-614.jpg\"><img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/353669547-651972905622466560-651972905622466562-615.jpg\"><img src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/241322868-651972905622466560-651972905622466562-616.jpg\"><img src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/270393169-651972905622466560-651972905622466562-617.jpg\"><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.662f0ed0bc4d3&p=1778844997&k=i_key&t=1714360017\" style=\"display:none\" />",
"desc_img": [
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/1540464613-651972905622466560-651972905622466562-601.jpg",
"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2056028139-651972905622466560-651972905622466562-602.jpg",
"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2103507544-651972905622466560-651972905622466562-603.jpg",
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/805209464-651972905622466560-651972905622466562-604.jpg",
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/965265007-651972905622466560-651972905622466562-605.jpg",
"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/1456204603-651972905622466560-651972905622466562-606.jpg",
"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/245784564-651972905622466560-651972905622466562-607.jpg",
"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/478942397-651972905622466560-651972905622466562-608.jpg",
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/563202406-651972905622466560-651972905622466562-609.jpg",
"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/576808585-651972905622466560-651972905622466562-610.jpg",
"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/492548576-651972905622466560-651972905622466562-611.jpg",
"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/475079584-651972905622466560-651972905622466562-612.jpg",
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/643984351-651972905622466560-651972905622466562-613.jpg",
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/723627373-651972905622466560-651972905622466562-614.jpg",
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/353669547-651972905622466560-651972905622466562-615.jpg",
"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/241322868-651972905622466560-651972905622466562-616.jpg",
"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/270393169-651972905622466560-651972905622466562-617.jpg"
],
"item_imgs": [
{
"url": "https://a.vpimg4.com/upload/merchandise/pdcvis/104218/2020/0814/160/7932992b-c2f6-4ed2-a97b-69824fa7ba10_750x750_75.jpg"
},
{
"url": "https://a.vpimg2.com/upload/merchandise/pdcvis/104218/2020/0610/171/dbe0c41b-4a98-49f3-a5ec-8a4da2866892_750x750_75.jpg"
},
{
"url": "https://a.vpimg2.com/upload/merchandise/pdcvis/104218/2020/0519/147/b64c59ed-838d-48df-bd78-89f55e375a5a_750x750_75.jpg"
},
{
"url": "https://a.vpimg3.com/upload/merchandise/pdcvis/104218/2020/0519/137/29223c17-dc85-412f-80c8-e0332f2f68d5_750x750_75.jpg"
},
{
"url": "https://a.vpimg2.com/upload/merchandise/pdcvis/104218/2020/0519/185/8cd6c2f7-bc39-49a5-bf98-cebb1e764dd4_750x750_75.jpg"
},
{
"url": "https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/25466546-651972905622466560-651972905622466562-2_750x750_75.jpg"
},
{
"url": "https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/1077608551-651972905622466560-651972905622466562-3_750x750_75.jpg"
},
{
"url": "https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/1680510077-651972905622466560-651972905622466562-4_750x750_75.jpg"
},
{
"url": "https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/1463673259-651972905622466560-651972905622466562-15_750x750_75.jpg"
},
{
"url": "https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/1627814802-651972905622466560-651972905622466562-16_750x750_75.jpg"
},
{
"url": "https://a.vpimg3.com/upload/merchandise/pdcvis/104218/2020/0610/102/36a2bb01-d66a-4ea9-a7b0-07b4231be7ec_750x750_75.jpg"
}
],
"item_weight": "",
"item_size": "",
"location": "",
"post_fee": "",
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"has_discount": "",
"video": "",
"is_virtual": "",
"sample_id": "",
"is_promotion": "false",
"props_name": "XL:黑色9000;M:黑色9000;XS:黑色9000;L:黑色9000;S:黑色9000;XXL:黑色9000;XXXL:黑色9000;",
"prop_imgs": {
"prop_img": []
},
"property_alias": "",
"props": null,
"total_sold": "0",
"skus": {
"sku": [
{
"price": "35",
"sales": 1,
"total_price": 0,
"orginal_price": "159",
"properti": {
"134": "黑色9000",
"453": "XL"
},
"quantity": null,
"sku_id": "6918711233889253253"
},
{
"price": "35",
"sales": 1,
"total_price": 0,
"orginal_price": "159",
"properti": {
"134": "黑色9000",
"453": "M"
},
"quantity": null,
"sku_id": "6918711233889257349"
},
{
"price": "35",
"sales": 1,
"total_price": 0,
"orginal_price": "159",
"properti": {
"134": "黑色9000",
"453": "XS"
},
"quantity": null,
"sku_id": "6918711233922930565"
},
{
"price": "35",
"sales": 1,
"total_price": 0,
"orginal_price": "159",
"properti": {
"134": "黑色9000",
"453": "L"
},
"quantity": null,
"sku_id": "6918711233939748741"
},
{
"price": "35",
"sales": 1,
"total_price": 0,
"orginal_price": "159",
"properti": {
"134": "黑色9000",
"453": "S"
},
"quantity": null,
"sku_id": "6918711233956571013"
},
{
"price": "35",
"sales": 1,
"total_price": 0,
"orginal_price": "159",
"properti": {
"134": "黑色9000",
"453": "XXL"
},
"quantity": null,
"sku_id": "6918711234007082885"
},
{
"price": "35",
"sales": 1,
"total_price": 0,
"orginal_price": "159",
"properti": {
"134": "黑色9000",
"453": "XXXL"
},
"quantity": null,
"sku_id": "6918711234023888773"
}
]
},
"seller_id": "",
"sales": 1,
"shop_id": "",
"props_list": [],
"seller_info": {
"title": "",
"shop_name": "唯品自营",
"sid": "",
"zhuy": "",
"level": "",
"shop_type": "",
"user_num_id": "ST00000",
"nick": "",
"cid": null,
"delivery_score": "",
"item_score": "",
"tell": "",
"addre": "",
"score_p": ""
},
"tmall": "false",
"error": "",
"warning": "",
"url_log": [],
"stuff_status": "",
"data_from": "ztk",
"method": "",
"promo_type": null,
"props_img": [],
"rate_grade": "",
"priceRange": [],
"shop_item": [],
"relate_items": [],
"shop_url": "",
"sn": "12B049261107-9000",
"format_check": "ok"
},
"error": "",
"secache": "ce598a0a94090cd039c992849588a446",
"secache_time": 1714360017,
"secache_date": "2024-04-29 11:06:57",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:46 max:10000 all[1133=46+85+1002];expires:2030-10-30",
"execution_time": "0.461",
"server_time": "Beijing/2024-04-29 11:06:57",
"client_ip": "106.7.5.69",
"call_args": {
"num_iid": "1710613157-6918711233889249157"
},
"api_type": "vip",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "3.16MB",
"request_id": "gw-1.662f0ed0bc4d3",
"last_id": "2874102687"
}