淘宝API在使用过程中可能会遇到多种错误,这些错误可能由不同的原因引起。以下是一些常见的淘宝API错误及其可能的原因:
-
签名错误:这通常是由于签名生成过程中出现问题导致的。例如,签名参数错误、签名方法不正确或签名顺序不一致等都可能导致签名错误。
-
API接口权限不足:如果调用API接口时没有足够的权限,就会出现权限不足的错误。这可能是因为应用未获得相应的API接口权限,或者权限已过期。
-
请求参数错误:如果API请求中的参数格式、类型或取值范围不符合要求,就会导致请求参数错误。这可能是因为开发者在构造请求时未仔细核对参数要求。
taobao.item_get_app
公共参数
登录 - 跨境电商平台接口提供商 数据采集公司 数据接口定制服务 企业级数据服务商
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:num_iid=520813250866
参数说明:num_iid:淘宝商品ID
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | Mix | 0 | 获得淘宝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) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
处理这些错误时,开发者可以采取以下措施:
- 检查API密钥的有效性,确保未过期。
- 仔细核对API请求参数,确保符合API文档的要求。
- 定期检查服务器状态,确保API服务器可用。
- 了解并遵守API的接口限制和配额规定,避免超限问题。
- 对于具体的错误码,可以查阅淘宝API的错误码对照表,了解错误原因和解决方案。
总之,处理淘宝API错误需要开发者具备扎实的编程知识和对API文档的深入理解。通过仔细排查错误原因并采取相应措施,可以有效解决大部分API使用过程中的问题。
标签:错误,app,error,忽略,天猫,API,参数,淘宝,true From: https://blog.csdn.net/API_you847337137/article/details/137045175