怎样获得微店店铺的所有商品 API 返回值说明？

于 2024-04-09 13:35:04 发布
阅读量1.8k 收藏 36
点赞数 47
文章标签： 数据库 java 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u012449366/article/details/137548476
版权

item_search_shop-获得店铺的所有商品

micro.item_search_shop

公共参数

请求地址: https://api-gw-4.cn/micro/item_search_shop

名称类型必须描述
keyString是调用key（必须以GET方式拼接在URL中）
secretString是调用密钥
api_nameString是API接口名称（包括在请求地址中）[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简体中文
versionString否API版本

请求参数

请求参数：userid=1785418864&page=&sort=&

参数说明： userid:shop_id
page:页码
sort:sort=1 销量 sort=0 综合 sort=5 价格 降序

响应参数

Version: Date:

名称类型必须示例值描述

title

String0HYKE x The North Face北面tnf联名中长款面包服羽绒服秋冬加厚保暖情侣外套商品标题

num_iid

String03490287840宝贝ID

price

Float0799价格

orginal_price

Float0799原价格

promotion_price

Float0799优惠价格

pic_url

String0https://si.geilicdn.com/pcitem1232497572-78fb000001765d42a8050a217205-unadjust_958_958.jpeg宝贝图片

sales

Int014830销量

seller_id

String0卖家ID

seller_nick

String0掌柜昵称

detail_url

String0https://weidian.com/item.html?itemID=3490287840宝贝链接

请求示例

- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw-4.cn/micro/item_search_shop/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&userid=1785418864&page=&sort=&"

响应示例

{
			"items": {
		"userid": "1785418864",
		"page": 1,
		"page_size": 20,
		"real_total_results": 2000,
		"total_results": 2000,
		"pagecount": 100,
		"data_from": "micro",
		"item": [
			{
				"title": "包装服务 详情询客服",
				"num_iid": "4244475449",
				"price": 1,
				"orginal_price": 1,
				"promotion_price": 1,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-08b40000017663b607c20a21348d-unadjust_900_1200.jpeg",
				"sales": 408,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4244475449"
			},
			{
				"title": "出口日本 薄绒加厚奥利绒发热休闲裤女士",
				"num_iid": "4162863529",
				"price": 320,
				"orginal_price": 320,
				"promotion_price": 320,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-5f7500000175cfe1972f0a21348d-unadjust_710_1001.jpeg?w=1125",
				"sales": 48,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4162863529"
			},
			{
				"title": "tanghulu mug 艺术家具 马卡龙色系糖葫芦咖啡杯",
				"num_iid": "4234886387",
				"price": 98,
				"orginal_price": 98,
				"promotion_price": 98,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-4cc5000001764f9c8db40a217216-unadjust_1124_1174.jpeg",
				"sales": 46,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4234886387"
			},
			{
				"title": "步履不停 新年礼物 家庭人手一双红红火火过大年 喜庆氛围袜子 男女同款（三双包邮）",
				"num_iid": "4276051344",
				"price": 8,
				"orginal_price": 8,
				"promotion_price": 8,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-3ead00000176f2e57bf90a21348d_800_1200.jpg",
				"sales": 46,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4276051344"
			},
			{
				"title": "加拿大运动品牌tna 人手一条高需求秋冬弹力高腰运动打底裤",
				"num_iid": "4057791539",
				"price": 76,
				"orginal_price": 76,
				"promotion_price": 76,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-179d0000017542a462580a21c2a8_1124_1182.jpg",
				"sales": 43,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4057791539"
			},
			{
				"title": "步履不停 男男女女老老少少皆可穿 羊毛混纺针织厚实毛袜子（5双包邮）",
				"num_iid": "4276072762",
				"price": 19,
				"orginal_price": 19,
				"promotion_price": 19,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-3efd00000176f2d5773e0a21c2a7_1124_1124.jpg",
				"sales": 43,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4276072762"
			},
			{
				"title": "Dou studio 秋冬混纺高领套头女士针织毛衣打底衫",
				"num_iid": "4226664141",
				"price": 128,
				"orginal_price": 128,
				"promotion_price": 128,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-515500000177048cbdb90a217216_1124_1500.jpg",
				"sales": 38,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4226664141"
			},
			{
				"title": "日单 多色秋冬oversize 纯色套头基础男女同款卫衣",
				"num_iid": "4234865463",
				"price": 98,
				"orginal_price": 98,
				"promotion_price": 98,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-75b5000001764e1176b20a217205-unadjust_790_1448.jpeg",
				"sales": 35,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4234865463"
			},
			{
				"title": "秋冬刚需必备 加绒加厚保暖 牛仔打底裤 三色",
				"num_iid": "4151263206",
				"price": 298,
				"orginal_price": 298,
				"promotion_price": 298,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-0c5100000175bddc87200a21348d-unadjust_1124_1500.jpeg",
				"sales": 34,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4151263206"
			},
			{
				"title": "happy socks 迪斯尼联名礼盒袜子ins潮 女",
				"num_iid": "4224764627",
				"price": 198,
				"orginal_price": 198,
				"promotion_price": 198,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-3a87000001763b7eb71d0a21c2a7-unadjust_640_705.jpeg",
				"sales": 29,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4224764627"
			},
			{
				"title": "比拥抱更温暖 来自内蒙古草原的馈赠纯羊毛围巾男女同款围巾 多色",
				"num_iid": "4244474625",
				"price": 188,
				"orginal_price": 188,
				"promotion_price": 188,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-6d4400000176635006580a21348d-unadjust_1125_1134.jpeg",
				"sales": 27,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4244474625"
			},
			{
				"title": "呀！好长一只腊肠狗 谁说长大后的不能有玩具？独居生活温暖好物 暖色系腊肠狗玩偶靠枕",
				"num_iid": "4270131842",
				"price": 98,
				"orginal_price": 98,
				"promotion_price": 98,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-2f0600000176dde56ea30a20b7b9_1125_1485.jpg?w=1125",
				"sales": 27,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4270131842"
			},
			{
				"title": "瑞典潮牌 Stalwart 复古小众 港味十足慢跑鞋",
				"num_iid": "4081762103",
				"price": 498,
				"orginal_price": 498,
				"promotion_price": 498,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-77380000017566ce7e370a217205-unadjust_1125_1315.jpeg",
				"sales": 26,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4081762103"
			},
			{
				"title": "大衣绝配 秋冬圆领羊毛混纺针织上衣 毛衣",
				"num_iid": "4235584538",
				"price": 128,
				"orginal_price": 128,
				"promotion_price": 128,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-6c42000001764e053d970a20b7b9-unadjust_1209_1845.jpeg",
				"sales": 26,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4235584538"
			},
			{
				"title": "B家超长超厚 狐狸毛领鹅绒填充可拆卸帽子女士羽绒服",
				"num_iid": "4033542331",
				"price": 1880,
				"orginal_price": 1880,
				"promotion_price": 1880,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-55f9000001760c5aa8a00a20b7b9-unadjust_1124_1500.jpeg",
				"sales": 23,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4033542331"
			},
			{
				"title": "Prad@ 原厂标齐 100%纯羊毛针织女士休闲裤",
				"num_iid": "4249743920",
				"price": 798,
				"orginal_price": 798,
				"promotion_price": 798,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-509300000176720b27600a20b7b9-unadjust_900_1100.jpeg",
				"sales": 23,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4249743920"
			},
			{
				"title": "澳洲羊毛冬季保暖针织抽绳休闲女款运动长裤",
				"num_iid": "4180378926",
				"price": 398,
				"orginal_price": 398,
				"promotion_price": 398,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-255d00000175e7de863a0a21348d-unadjust_1122_1496.jpeg",
				"sales": 23,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4180378926"
			},
			{
				"title": "出口日单 秋冬打底 不可辜负单品圆领套头衫",
				"num_iid": "4234938421",
				"price": 168,
				"orginal_price": 168,
				"promotion_price": 168,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-7e50000001764e209c670a217216-unadjust_2250_3333.jpeg",
				"sales": 23,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4234938421"
			},
			{
				"title": "M 冬季新款短款 鹅绒填充镭射白色光面面包羽绒服",
				"num_iid": "4033553399",
				"price": 1350,
				"orginal_price": 1350,
				"promotion_price": 1350,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-20dc0000017608517f360a217216-unadjust_1124_1752.jpeg?w=1125",
				"sales": 21,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4033553399"
			},
			{
				"title": "爆竹声中一岁除 施华洛世奇水晶新年特别礼故宫宫廷联名风格礼物首选福禄首饰",
				"num_iid": "4259836219",
				"price": 188,
				"orginal_price": 188,
				"promotion_price": 188,
				"pic_url": "https://si.geilicdn.com/wdseller1447298905-0d5c00000176a20a640e0a21348d-unadjust_750_750.jpeg?w=1125",
				"sales": 21,
				"seller_id": "1785418864",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4259836219"
			}
		]
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "0d0ed7bb4627f1b41cd6caaeea8bfbc1",
	"secache_time": 1611125558,
	"secache_date": "2021-01-20 14:52:38",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:1 max:5000",
	"execution_time": 0.923,
	"server_time": "Beijing/2021-01-20 14:52:38",
	"client_ip": "115.151.186.91",
	"call_args": {
		"seller_nick": "1785418864"
	},
	"api_type": "micro",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "2.76MB",
	"request_id": "1.6007d33539b5c"
	}

异常示例

{
  "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": "taobao",
  "request_id": "15ee0ffc041242"}

相关资料

错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据是
2000Search success but no result接口访问成功，但是搜索没有结果是
4000Server internal error服务器内部错误否
4001Network error网络错误否
4002Target server error目标服务器错误否
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时否
5000unknown error未知错误否

API 工具

微店获得店铺所有商品的API返回值通常包含了一系列与商品相关的信息。具体的返回值字段和格式可能因微店API的版本和更新而有所变化，因此建议直接参考微店开放平台的官方API文档以获取最准确和最新的信息。

一般而言，通过调用微店店铺所有商品数据接口，你可以获取到店铺内所有商品的详细信息。这些信息可能包括但不限于：

  1. 商品ID：唯一标识一个商品的编号。
  2. 商品名称：商品的标题或名称。
  3. 商品价格：商品的售价或标价。
  4. 商品描述：对商品的详细描述或介绍。
  5. 商品图片：商品的图片URL或链接，用于展示商品的外观。
  6. 库存数量：商品的库存量或剩余可售数量。
  7. 分类信息：商品所属的分类或类别。
  8. 其他属性：可能还包括商品的品牌、尺寸、颜色等其他属性信息。

需要注意的是，具体的API返回值字段和格式可能因微店的API设计而有所差异。因此，在使用微店API时，务必参考官方文档以了解准确的返回值结构和含义。

此外，API的返回值通常是以JSON格式返回的，这是一种常见的数据交换格式。你可以使用编程语言中的JSON解析库或工具来解析和处理这些返回值，以便在你的应用中使用这些商品信息。

总结来说，要获取微店店铺所有商品API的返回值说明，最准确的方式是查阅微店开放平台的官方API文档。文档中将详细列出API的返回值字段、格式和含义，帮助你正确地解析和使用这些商品信息。

own0314
关注
  • 47
    点赞
  • 踩
  • 36
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值