淘宝/天猫获得店铺的所有商品、店铺列表接口API返回值说明

以下是行业内了解到的一些情况,本帖只展示部分代码,需要更多API调试请移步注册API账号

公共参数

名称类型必须描述
keyString调用key   点击获取测试key和secret
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版本

请求参数

请求参数:shop_id=433655136&page=1&sort=

参数说明: shop_id:shop_id page:页码
sort:排序[new,bid,sale]
  (new 新品,bid:价格,sale:销量,bid加_前缀为从大到小排序)

响应参数

名称类型必须示例值描述

num_iid

Bigint0579813460997商品ID

pic_url

String0//img.alicdn.com/bao/uploaded/i3/478952498/O1CN011UK7q9WzgFGKQw8_!!478952498.jpg图片地址

title

String0英伦小皮鞋女复古2020秋冬新款网红毛毛鞋女百搭外穿粗跟中跟单鞋店铺标题

orginal_price

String0398.00优惠价

price

Float0148价格

sales

Int07销量

detail_url

String0//item.taobao.com/item.htm?id=579813460997宝贝链接

返回结果

{
	"items": {
		"shop_id": "433655136",
		"page": "1",
		"has_next_page": "true",
		"real_total_results": "72",
		"total_results": "72",
		"page_size": 16,
		"page_count": 4,
		"_ddf": "ti",
		"item": [
			{
				"num_iid": "674677242275",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01SlWToI1nzKSvsvDo2_!!2209411885160.jpg",
				"title": "IFIK Denim Mini Skort 白鹿同款 '辣妹教条'牛仔低腰复古短裙裤",
				"promotion_price": "350.00",
				"price": "350.00",
				"sales": 758,
				"quantity": "2037",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=674677242275"
			},
			{
				"num_iid": "674342109993",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01x2oAnJ1nzKSRWjJMF_!!2209411885160.jpg",
				"title": "IFIK Bootcut Jeans #1969 50粒铆钉复古高腰微喇重洗水牛仔裤",
				"promotion_price": "400.00",
				"price": "400.00",
				"sales": 586,
				"quantity": "3226",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=674342109993"
			},
			{
				"num_iid": "647240758820",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01Y3P5gp1nzKNxN6FbG_!!2209411885160.jpg",
				"title": "IFIK \"Cowgirl\" Print 2-Use Bandana 整一个西部风情的方巾/抹胸",
				"promotion_price": "99.00",
				"price": "99.00",
				"sales": 565,
				"quantity": "321",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=647240758820"
			},
			{
				"num_iid": "675006395148",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01aUT9ek1nzKTEwLfVw_!!2209411885160.jpg",
				"title": "IFIK Leather Jacket 'Hunter复古水洗牛仔拼皮夹克 短款垫肩外套",
				"promotion_price": "580.00",
				"price": "580.00",
				"sales": 381,
				"quantity": "378",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=675006395148"
			},
			{
				"num_iid": "668871730997",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01oTX8pT1nzKRJAF4kU_!!2209411885160.jpg",
				"title": "IFIK Cargo Pants「工装裤工艺天花板」阔腿口袋洗水牛仔长裤2色",
				"promotion_price": "450.00",
				"price": "450.00",
				"sales": 896,
				"quantity": "352",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=668871730997"
			},
			{
				"num_iid": "671047562893",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01GojMeK1nzKRjZ6atG_!!2209411885160.jpg",
				"title": "IFIK Body Chain 于文文同款 金属与牛仔的碰撞Chocker身体链腰链",
				"promotion_price": "180.00",
				"price": "180.00",
				"sales": 384,
				"quantity": "542",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=671047562893"
			},
			{
				"num_iid": "674677778191",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01c1wYun1nzKSibRX4Y_!!2209411885160.jpg",
				"title": "IFIK Pink Blazer90s多位重洗水粉色Y2K辣妹牛仔西服垫肩西装外套",
				"promotion_price": "630.00",
				"price": "630.00",
				"sales": 258,
				"quantity": "1635",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=674677778191"
			},
			{
				"num_iid": "674358013064",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01rftHTN1nzKStEYuhe_!!2209411885160.jpg",
				"title": "IFIK Denim Sweatpants轻松复古 垂坠感重度洗水直筒牛仔运动卫裤",
				"promotion_price": "350.00",
				"price": "350.00",
				"sales": 163,
				"quantity": "1003",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=674358013064"
			},
			{
				"num_iid": "670696261652",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01eWda891nzKSWUN4pA_!!2209411885160.jpg",
				"title": "IFIK Baggy Jeans#1997复古水洗U形口袋涂鸦低腰拖地阔腿牛仔长裤",
				"promotion_price": "460.00",
				"price": "460.00",
				"sales": 201,
				"quantity": "110",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=670696261652"
			},
			{
				"num_iid": "673015183063",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01knXItb1nzKRs1bd9l_!!2209411885160.jpg",
				"title": "IFIK Denim Tote 百搭实用 经典款纯色LOGO压印牛仔帆布袋托特包",
				"promotion_price": "100.00",
				"price": "100.00",
				"sales": 392,
				"quantity": "1465",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=673015183063"
			},
			{
				"num_iid": "670709161783",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01EoODNl1nzKSZqqVGU_!!2209411885160.jpg",
				"title": "IFIK Ripped Shorts 'Railway叛逆街头翻边破坏高腰热裤牛仔短裤",
				"promotion_price": "330.00",
				"price": "330.00",
				"sales": 384,
				"quantity": "2450",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=670709161783"
			},
			{
				"num_iid": "670733077588",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01y21SnV1nzKRqx1cIt_!!2209411885160.jpg",
				"title": "IFIK Leg Belt Bag 'Dressage' 月牙形牛仔暗纹绑带腿包迷你包",
				"promotion_price": "380.00",
				"price": "380.00",
				"sales": 261,
				"quantity": "666",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=670733077588"
			},
			{
				"num_iid": "671369999374",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01T3ls3D1nzKS87vG1J_!!2209411885160.jpg",
				"title": "IFIK Iconic Soft Terry Set牛仔绣花排钻毛巾料卫衣+喇叭卫裤2色",
				"promotion_price": "320.00",
				"price": "320.00",
				"sales": 540,
				"quantity": "2375",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=671369999374"
			},
			{
				"num_iid": "674733462843",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN018YFwTw1nzKSdKmwip_!!2209411885160.jpg",
				"title": "IFIK Underwear Set 链条挂脖腰部logo设计亲肤洗水牛仔内衣套装",
				"promotion_price": "190.00",
				"price": "190.00",
				"sales": 146,
				"quantity": "46",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=674733462843"
			},
			{
				"num_iid": "674736794134",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01u5KuJI1nzKSmt3oMD_!!2209411885160.jpg",
				"title": "IFIK Denim Jumpsuit 90S小辣椒 Polo背心修身洗水黑连体牛仔短裤",
				"promotion_price": "380.00",
				"price": "380.00",
				"sales": 103,
				"quantity": "30",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=674736794134"
			},
			{
				"num_iid": "676451102881",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01gW4N8c1nzKSqQXGU2_!!2209411885160.jpg",
				"title": "IFIK Denim Boxer Shorts 美式慵懒 洗水棕 牛仔松紧运动拳击短裤",
				"promotion_price": "280.00",
				"price": "280.00",
				"sales": 70,
				"quantity": "1900",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=676451102881"
			}
		]
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "5177b6f4db5be7bfce9032529452fd88",
	"secache_time": 1659317511,
	"secache_date": "2022-08-01 09:31:51",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:30 max:10100 all[48=30+5+13];expires:2030-12-31",
	"execution_time": "1.689",
	"server_time": "Beijing/2022-08-01 09:31:51",
	"client_ip": "106.6.35.126",
	"call_args": {
		"seller_nick": "433655136",
		"start_price": "1"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "5.95MB",
	"request_id": "gw-3.62e72d0648880",
	"last_id": "1119494491"
}

  • 2
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Java标准的接口返回API返回值的标准化通常采用RESTful API风格,具体而言,可以采用以下几个方面来实现: 1. HTTP状态码:根据HTTP协议的规范,服务器应该返回一个合适的HTTP状态码,以表明操作是否成功,比如200代表成功、400代表客户端请求错误、401代表未授权、500代表服务器内部错误等。 2. JSON数据格式:通常情况下,API返回的数据都采用JSON格式进行传输,这样可以方便客户端进行解析和处理。在JSON格式中,可以定义一些统一的字段,比如code、msg、data等,用于表示返回的状态码、消息和数据等信息。 下面是一个Java接口返回API返回值的标准化示例代码: ``` @RestController @RequestMapping("/api") public class UserController { @Autowired private UserService userService; @GetMapping("/user/{id}") public Result<User> getUserById(@PathVariable("id") Long id) { User user = userService.getUserById(id); if (user == null) { return Result.error(ResultCode.NOT_FOUND); } return Result.success(user); } @PostMapping("/user") public Result<Void> addUser(@RequestBody User user) { userService.addUser(user); return Result.success(); } @PutMapping("/user/{id}") public Result<Void> updateUser(@PathVariable("id") Long id, @RequestBody User user) { userService.updateUser(id, user); return Result.success(); } @DeleteMapping("/user/{id}") public Result<Void> deleteUser(@PathVariable("id") Long id) { userService.deleteUser(id); return Result.success(); } } ``` 其中,Result是一个自定义的类,用于封装API返回值,示例代码如下: ``` public class Result<T> { private int code; private String msg; private T data; public Result(int code, String msg, T data) { this.code = code; this.msg = msg; this.data = data; } public static <T> Result<T> success() { return new Result<>(ResultCode.SUCCESS.getCode(), ResultCode.SUCCESS.getMsg(), null); } public static <T> Result<T> success(T data) { return new Result<>(ResultCode.SUCCESS.getCode(), ResultCode.SUCCESS.getMsg(), data); } public static <T> Result<T> error(ResultCode resultCode) { return new Result<>(resultCode.getCode(), resultCode.getMsg(), null); } // 省略getter和setter方法 } ``` 在这里,我们使用了枚举类型ResultCode来统一定义返回状态码和消息。这样,对于每个接口返回的结果,都会包含一个状态码、一个消息和一个数据对象。客户端可以根据状态码和消息来判断API调用是否成功,数据对象则包含了具体的返回数据。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值