淘宝/天猫获得淘宝app商品详情原数据 API接口数据，有哪些常见的错误

原创 于 2024-03-26 14:48:34 发布 · 2.6k 阅读 · 15 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#前端 #api接口 #api #数据库

本文详细介绍了淘宝API在使用中可能出现的几种常见错误，如签名错误、权限不足和请求参数错误，以及如何通过检查API密钥、核对参数和查阅错误码来解决问题。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

淘宝API在使用过程中可能会遇到多种错误，这些错误可能由不同的原因引起。以下是一些常见的淘宝API错误及其可能的原因：

  1. 签名错误：这通常是由于签名生成过程中出现问题导致的。例如，签名参数错误、签名方法不正确或签名顺序不一致等都可能导致签名错误。

  2. API接口权限不足：如果调用API接口时没有足够的权限，就会出现权限不足的错误。这可能是因为应用未获得相应的API接口权限，或者权限已过期。

  3. 请求参数错误：如果API请求中的参数格式、类型或取值范围不符合要求，就会导致请求参数错误。这可能是因为开发者在构造请求时未仔细核对参数要求。

taobao.item_get_app

公共参数

登录 - 跨境电商平台接口提供商 数据采集公司 数据接口定制服务 企业级数据服务商

名称类型必须描述
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版本

请求参数

请求参数：num_iid=520813250866

参数说明：num_iid:淘宝商品ID

响应参数

Version: Date:

名称类型必须示例值描述

item

Mix0获得淘宝app商品详情原数据

 

响应示例

{
		"item": {
			"apiStack": [
				{
					"name": "esi",
					"value": {
						"consumerProtection": {
							"items": [
								{
									"title": "付款后48小时内发货"
								},
								{
									"desc": "8天退货，退货邮费买家承担",
									"title": "8天退货"
								},
								{
									"desc": "商品在运输途中出现破损的，消费者可向卖家提出补寄申请，可补寄1次，补寄邮费由买家承担",
									"title": "1次破损补寄"
								},
								{
									"desc": "购买该商品，每笔成交都会有相应金额捐赠给公益。感谢您的支持，愿公益的快乐伴随您每一天。",
									"title": "公益宝贝"
								},
								{
									"title": "集分宝"
								},
								{
									"title": "支付宝支付"
								}
							],
							"passValue": "all"
						},
						"debug": {
							"app": "alidetail",
							"host": "taodetail033005068013.center.na610@33.5.68.13"
						},
						"delivery": {
							"addressWeexUrl": "https://market.m.taobao.com/apps/market/detailrax/address-picker.html?spm=a2116h.app.0.0.16d957e9nDYOzv&wh_weex=true",
							"areaId": "330102",
							"completedTo": "杭州 上城 小营",
							"extras": [],
							"from": "广东深圳",
							"overseaContraBandFlag": "false",
							"postage": "快递: 快递包邮",
							"to": "杭州上城"
						},
						"diversion": {
							"detailTopSearch": {
								"url": "https://s.m.taobao.com/h5entry?g_channelSrp=detail&placeholder=合法刀 随身&showText=合法刀 随身&g_historyOn=true&g_csearchdoor_spm=a2141.13130650&itemId=520813250866&detailShopId=127203758"
							},
							"productRecommend": {
								"preloadUrl": "https://gw.alicdn.com/tfs/TB1PS8nBAPoK1RjSZKbXXX1IXXa-1125-1335.png?getAvatar=avatar",
								"request": {
									"api": "mtop.relationrecommend.WirelessRecommend.recommend",
									"params": {
										"appId": "10777",
										"from": "dinamicX",
										"params": "{\"itemid\":520813250866,\"spm\":\"0.0.0.0.hUro0P\",\"sellerid\":2596264565,\"appId\":\"10777\"}"
									},
									"version": "2.0"
								},
								"template": {
									"android": "https://ossgw.alicdn.com/rapid-oss-bucket/template_online/tb_shop_recommend/64005743/tb_shop_recommend_android.xml",
									"ios": "https://ossgw.alicdn.com/rapid-oss-bucket/template_online/tb_shop_recommend/64005743/tb_shop_recommend_ios.plist",
									"name": "tb_shop_recommend",
									"version": "37"
								}
							}
						},
						"extendedData": [],
						"feature": {
							"UTABForceNewSku": "true",
							"bigImageSkuProp": "true",
							"cainiaoNoramal": "true",
							"dailyPrice": "true",
							"enableDpbModule": "false",
							"freshmanRedPacket": "true",
							"guessYouLike": "true",
							"hasCoupon": "true",
							"hasNewCombo": "false",
							"hasSku": "true",
							"newAddress": "true",
							"newIndicator": "true",
							"newPrice": "true",
							"newTaobaoActivity": "true",
							"noShareGroup": "true",
							"openAddOnTools": "false",
							"openGradient": "true",
							"openNewSku": "true",
							"promotion2018": "true",
							"promotion2019": "true",
							"showSku": "true",
							"showSkuThumbnail": "true",
							"superActTime": "false",
							"taobao2018": "true"
						},
						"gallery": [],
						"hybrid": {
							"shopRecommendItems": {
								"height": "445",
								"spm": "",
								"url": "https://market.m.taobao.com/apps/market/detailrax/recommend-shop-bigpage.html?spm=a2116h.app.0.0.16d957e9B7oLGw&wh_weex=true&sellerId=2596264565&itemId=520813250866&detail_v=3.1.1&selfRmdFlag=true"
							}
						},
						"item": {
							"couponUrl": "//h5.m.taobao.com/present/hongbao.html?sellerId=2596264565",
							"picGallaryOverScroll": {
								"mainPic": {
									"action": [
										{
											"fields": {
												"url": "https://market.m.taobao.com/app/detail-project/pages/pages/banner-recommend?wx_navbar_hidden=true&_wx_statusbar_hidden=true&wh_weex=true&sellerId=2596264565&shopId=127203758&itemId=520813250866&spm=a2141.7631564&detailAlgoParam=&list_param=&abtest=76992_63166&detailUniqueId=02288d69701058eca52532215b7fed17"
											},
											"type": "open_url"
										},
										{
											"fields": {
												"trackName": "Page_Detail_Button-ItemDetailRecommend",
												"trackParams": {
													"spm": "a2141.7631564"
												}
											},
											"type": "user_track"
										}
									],
									"text": "滑\n动\n查\n看\n更\n多\n宝\n贝"
								}
							},
							"showShopActivitySize": "2",
							"skuText": "请选择 颜色分类 ",
							"titleIcon": "",
							"vagueSellCount": "16"
						},

 异常示例

{
		"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服务器可用。
  • 了解并遵守API的接口限制和配额规定，避免超限问题。
  • 对于具体的错误码，可以查阅淘宝API的错误码对照表，了解错误原因和解决方案。

总之，处理淘宝API错误需要开发者具备扎实的编程知识和对API文档的深入理解。通过仔细排查错误原因并采取相应措施，可以有效解决大部分API使用过程中的问题。

评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值