此API目前支持以下基本接口:
- item_get 根据ID取商品详情
- item_search 根据关键词取商品列表
- item_search_data 获得搜索词统计
- item_search_suggest 获得搜索词推荐
pinduoduo.item_get
公共参数
API测试工具
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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=1620002566
参数说明:num_iid:商品ID ;
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid | String | 0 | 1999629976 | 商品ID |
title | String | 0 | 2019新款女装短袖t恤女夏宽松韩版休闲上衣百搭蝙蝠衫五分袖体恤 | 商品标题 |
price | Float | 0 | 8.8 | 价格 |
minGroupPrice | String | 0 | ||
maxGroupPrice | String | 0 | ||
total_price | Float | 0 | ||
orginal_price | Float | 0 | 原价 | |
nick | String | 0 | 雅怡服饰1688 | 卖家昵称 |
num | Int | 0 | 233 | 库存 |
sales | Int | 0 | 76 | 销量 |
detail_url | String | 0 | http://yangkeduo.com/goods.html?goods_id=1999629976 | 宝贝链接 |
desc | String | 0 | 本店默认申通快递【还有百世汇通 中通快递 中通 韵达 邮政】。商家建议尺码仅供参考。如有其它问题请及时联系客服!喜欢的赶紧购买,质量保证,买的放心,穿的也开心! | 商品备注 |
item_imgs | Mix | 0 | [{"url": "//t00img.yangkeduo.com/t05img/images/2018-06-28/24bcb29df1195edaea840afd3e1bdaf9.jpeg?imageMogr2/strip%7CimageView2/2/w/1300/q/80"}] | 宝贝图片列表 |
pic_url | String | 0 | //t00img.yangkeduo.com/t05img/images/2018-06-28/24bcb29df1195edaea840afd3e1bdaf9.jpeg?imageMogr2/thumbnail/150x/quality/50 | 宝贝图片 |
props_name | String | 0 | 商品属性名 | |
prop_imgs | Mix | 0 | {"prop_img": [ {"properties": "0:0;1:1", "url": "//t00img.yangkeduo.com/t10img/images/2018-06-28/5c8f783ab2c4fea0ffea8fac73d8b2c2.jpeg"}]} | 商品属性图片列表 |
props | Mix | 0 | 商品详情 | |
skus | Mix | 0 | {"sku": [{"price": "16.56", "total_price": null, "orginal_price": "20.9", "properties": "0:0;1:1", "properties_name": "0:0:颜色:黑色;1:1:尺码:M【75-100斤】", "quantity": 221, "sku_id": 36410965966}] | 商品规格信息 |
props_list | Mix | 0 | { "0:0": "颜色:黑色","1:1": "尺码:M【75-100斤】"} | 商品属性 |
props_img | Mix | 0 | {"0:0;1:1": "//t00img.yangkeduo.com/t10img/images/2018-06-28/5c8f783ab2c4fea0ffea8fac73d8b2c2.jpeg"} | 属性图片 |
property_alias | String | 0 | 商品属性别名 | |
seller_info | Mix | 0 | {"nick": "雅怡服饰1688", "city": "", "level": null, "rate": null, "score": 4.27, "delivery_score": 4.37, "item_score": 4.38, "shop_type": "", "user_num_id": "", "sid": 99033, "shop_name": "雅怡服饰1688", "zhuy": "", "menu": [] } | 卖家信息 |
shop_item | Mix | 0 | [] | |
relate_items | Mix | 0 | [] |
错误码解释
状态代码(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 | 未知错误 | 否 |
如果在测试拼多多根据ID取商品详情API接口的过程中出现错误,可以按照以下步骤进行处理:
-
检查错误信息:首先,仔细阅读API返回的错误信息或错误代码。这通常会提供关于错误原因的线索,比如参数错误、权限不足、请求格式不正确等。
-
核对API文档:重新检查你使用的API文档,确保你遵循了所有正确的请求格式、参数和规则。有时候,简单的打字错误或参数遗漏都可能导致错误。
-
检查API密钥和权限:确认你的API密钥是否正确,并且你的账号是否拥有足够的权限去访问该API接口。有时候,权限不足或密钥错误是导致请求失败的原因。
-
查看日志和调试信息:如果你能够访问服务器或API的日志,那么查看相关的日志信息可能会帮助你定位问题。同时,开启本地代码调试功能,逐步跟踪请求发送和响应接收的过程,看是否有异常发生。
-
联系技术支持:如果上述步骤都无法解决问题,你可以尝试联系技术支持或开放平台客服。提供详细的错误信息和你已经尝试过的解决步骤,以便他们能够更好地帮助你解决问题。
-
检查网络问题:有时候,网络问题也可能导致API请求失败。确保你的网络连接是稳定的,并且没有被防火墙或其他安全软件阻止。
-
查看API更新和变更日志:拼多多可能会不定期更新API接口或变更参数规则。检查是否有相关的更新或变更,确保你的代码与之兼容。
-
参考社区和论坛:访问拼多多的开发者社区或相关论坛,看看是否有其他开发者遇到过类似的问题,并分享了解决方案。
处理错误时,耐心和细心是关键。通过仔细检查和逐步排查,你通常能够找到导致错误的原因,并采取相应的措施解决问题。同时,保持与拼多多技术支持的沟通,他们可能会提供更具体的帮助和指导。