微店商品详情API接口,json数据返回

简介: 微店商品详情API接口的典型JSON返回数据结构说明,基于公开的微店开放平台API文档和常见电商API设计模式整理。实际使用时请以微店官方最新文档为准

以下是微店商品详情API接口的典型JSON返回数据结构说明,基于公开的微店开放平台API文档和常见电商API设计模式整理。实际使用时请以微店官方最新文档为准。


1. 接口基本信息

  • method: vdian.item.get(获取商品详情)
  • access_token: 授权Token
  • item_id: 商品ID

2. JSON返回数据结构

成功响应示例

json
{
"status": {
"status_code": 0,
"status_reason": "success"
},
"result": {
"item": {
"item_id": "123456789",
"title": "商品标题",
"subtitle": "商品副标题",
"price": 99.9,
"original_price": 199.9,
"stock": 100,
"sold": 50,
"status": 1,
"images": [
"http://img.weidian.com/item/1.jpg",
"http://img.weidian.com/item/2.jpg"
],
"description": "<div>商品详细描述HTML</div>",
"skus": [
{
"sku_id": "sku123",
"specs": [
{"name": "颜色", "value": "红色"},
{"name": "尺寸", "value": "M"}
],
"price": 99.9,
"stock": 20,
"sku_image": "http://img.weidian.com/sku/1.jpg"
}
],
"category": {
"id": "cate123",
"name": "服装"
},
"shop": {
"shop_id": "shop456",
"name": "微店名称",
"logo": "http://img.weidian.com/shop/logo.jpg"
},
"postage": 10.0,
"is_free_postage": false,
"created": 1672502400,
"modified": 1673020800
}
}
}

失败响应示例

json
{
"status": {
"status_code": 40001,
"status_reason": "invalid item_id"
}
}

3. 字段详细说明

顶层字段

字段 类型 说明
status Object 接口调用状态
result Object 返回的业务数据

status 对象

字段 类型 说明
status_code Int 状态码(0表示成功)
status_reason String 状态描述(如"success"或错误原因)

result.item 对象(商品详情)

字段 类型 说明
item_id String 商品唯一ID
title String 商品标题
subtitle String 商品副标题(可选)
price Float 当前价格
original_price Float 原价(可选)
stock Int 总库存
sold Int 已售数量
status Int 商品状态(1:在售, 0:下架)
images Array 商品图片URL数组
description String 商品描述(HTML格式)
skus Array SKU列表(见下文)
category Object 商品分类信息
shop Object 店铺信息
postage Float 运费(单位:元)
is_free_postage Boolean 是否包邮
created Int 创建时间(Unix时间戳)
modified Int 最后修改时间(Unix时间戳)

skus 数组中的对象

字段 类型 说明
sku_id String SKU唯一ID
specs Array 规格属性数组(每个规格包含namevalue
price Float SKU价格
stock Int SKU库存
sku_image String SKU特有图片URL(可选)

category 对象

字段 类型 说明
id String 分类ID
name String 分类名称

shop 对象

字段 类型 说明
shop_id String 店铺ID
name String 店铺名称
logo String 店铺Logo URL

4. Python采集代码示例

python
import requests
import json
def get_weidian_item(item_id, access_token):
    url = "https://api.vdian.com/api"
    params = {
"method": "vdian.item.get",
"access_token": access_token,
"item_id": item_id,
"version": "1.0"
    }
try:
        response = requests.get(url, params=params)
        data = response.json()
if data["status"]["status_code"] == 0:
return data["result"]["item"]
else:
print(f"API Error: {data['status']['status_reason']}")
return None
except Exception as e:
print(f"Request failed: {str(e)}")
return None
# 示例调用
item_data = get_weidian_item("123456789", "your_access_token")
if item_data:
print(json.dumps(item_data, indent=2, ensure_ascii=False))


相关文章
|
6天前
|
JSON 缓存 自然语言处理
多语言实时数据微店商品详情API:技术实现与JSON数据解析指南
通过以上技术实现与解析指南,开发者可高效构建支持多语言的实时商品详情系统,满足全球化电商场景需求。
|
2天前
|
缓存 监控 供应链
亚马逊 MWS API 实战:商品详情精准获取与跨境电商数据整合方案
本文详细解析亚马逊MWS API接口的技术实现,重点解决跨境商品数据获取中的核心问题。文章首先介绍MWS接口体系的特点,包括多站点数据获取、AWS签名认证等关键环节,并对比普通电商接口的差异。随后深入拆解API调用全流程,提供签名工具类、多站点客户端等可复用代码。针对跨境业务场景,文章还给出数据整合工具实现方案,支持缓存、批量处理等功能。最后通过实战示例展示多站点商品对比和批量选品分析的应用,并附常见问题解决方案。该技术方案可直接应用于跨境选品、价格监控等业务场景,帮助开发者高效获取亚马逊商品数据。
|
5天前
|
JSON API 数据安全/隐私保护
Python采集淘宝评论API接口及JSON数据返回全流程指南
Python采集淘宝评论API接口及JSON数据返回全流程指南
|
2天前
|
供应链 监控 安全
1688商品详情API接口实战指南:合规获取数据,驱动B2B业务增长
1688商品详情API(alibaba.product.get)是合规获取B2B商品数据的核心工具,支持全维度信息调用,助力企业实现智能选品、供应链优化与市场洞察,推动数字化转型。
|
2天前
|
人工智能 供应链 API
淘宝API商品详情接口全解析:从基础数据到深度挖掘
淘宝API商品详情接口不仅提供基础数据,更通过深度挖掘实现从数据到洞察的跨越。开发者需结合业务场景选择合适分析方法,利用AI标签、区块链溯源等新技术,最终实现数据驱动的电商业务创新。
|
5天前
|
自然语言处理 监控 API
小红书爆文解码:用API分析互动数据,精准指导创作方向
在内容为王时代,爆文背后有科学公式!通过小红书API抓取百万笔记数据,提炼出点赞转化率、收藏价值系数、评论情感值三大核心指标,揭秘爆文特征不等式与内容元素矩阵,手把手教你用数据驱动创作,实现从0到百万曝光的逆袭!
41 0
|
1月前
|
JSON API 数据格式
淘宝/天猫图片搜索API接口,json返回数据。
淘宝/天猫平台虽未开放直接的图片搜索API,但可通过阿里妈妈淘宝联盟或天猫开放平台接口实现类似功能。本文提供基于淘宝联盟的图片关联商品搜索Curl示例及JSON响应说明,适用于已获权限的开发者。如需更高精度搜索,可选用阿里云视觉智能API。
|
1月前
|
JSON API 数据安全/隐私保护
深度分析淘宝卖家订单详情API接口,用json返回数据
淘宝卖家订单详情API(taobao.trade.fullinfo.get)是淘宝开放平台提供的重要接口,用于获取单个订单的完整信息,包括订单状态、买家信息、商品明细、支付与物流信息等,支撑订单管理、ERP对接及售后处理。需通过appkey、appsecret和session认证,并遵守调用频率与数据权限限制。本文详解其使用方法并附Python调用示例。
|
18天前
|
机器学习/深度学习 JSON 监控
淘宝拍立淘按图搜索与商品详情API的JSON数据返回详解
通过调用taobao.item.get接口,获取商品标题、价格、销量、SKU、图片、属性、促销信息等全量数据。
|
19天前
|
JSON API 数据格式
干货满满!淘宝商品详情数据,淘宝API(json数据返回)
淘宝商品详情 API 接口(如 taobao.item.get)的 JSON 数据返回示例如下