淘宝API开发系列：淘宝api接口接入说明

Posted 2021-03-02

为了进行淘宝API接口开发，正常会有以下几个步骤操作：

1）开发者注册一个账号。

2）然后为每个淘宝应用注册一个应用程序键（App Key) 。

3）下载淘宝API的SDK并掌握基本的API基础知识和调用，具体可以参考博客的信息点击查看详细接口说明里面的技术分享区等。
3）下载淘宝API的SDK并掌握基本的API基础知识和调用，具体可以参考博客的信息（淘宝商品详情介绍请添加链接描述）里面的技术分享区等。

4）利用SDK接口和对象，传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发。

5）利用淘宝平台的文档中心和API测试工具，对接口进行测试。从而了解返回信息，方便程序获取。

6）无需以上五点，可直接注册账号调用接口，点击开通（Key和Secret）测试。

以上是一般淘宝API应用开发的关键流程，其中通过淘宝文档中心和API测试工具，进行概念了解和接口信息查询很重要。支持平台有淘宝、天猫、1688、京东、阿里巴巴、阿里妈妈、亚马逊、Eaby、lazada、拼多多、翻译接口等25个平台数据。

支持淘宝API接口如下：

item_get - 获得淘宝商品详情
item_review - 获得淘宝商品评论
item_fee - 获得淘宝商品快递费用
item_password - 获得淘口令真实url
item_list_updown - 批量获得淘宝商品上下架时间
seller_info - 获得淘宝店铺详情
item_search - 按关键字搜索淘宝商品
item_search_img - 按图搜索淘宝商品（拍立淘）
item_search_shop - 获得店铺的所有商品
item_search_guang - 爱逛街
item_search_suggest - 获得搜索词推荐
item_search_jupage - 天天特价
item_search_coupon - 优惠券查询
cat_get - 获得淘宝分类详情
item_cat_get - 获得淘宝商品类目
item_search_samestyle - 搜索同款的商品
item_search_similar - 搜索相似的商品
item_sku - 获取sku详细信息
item_recommend - 获取推荐商品列表
brand_cat - 获取品牌分类列表
brand_cat_top - 获取分类推荐品牌列表
buyer_cart_add - 添加到购物车
buyer_cart_remove - 删除购物车商品
buyer_cart_list - 获取购物车的商品列表
buyer_order_list - 获取购买到的商品订单列表
buyer_order_detail - 获取购买到的商品订单详情
buyer_order_express - 获取购买到的商品订单物流
buyer_info - 买家信息
seller_order_list - 获取卖出的商品订单列表
upload_img - 上传图片到淘宝
img2text - 图片识别商品接口
功能介绍/Introduction
天猫商城数据对接服务包含有：
1、淘宝关键词搜索结果列表数据；
2、通过淘宝商品id获得淘宝商品详情数据；
3、查找店铺所有商品
4、根据分类查找商品
5、...
经过当前压力测试，可以承受 3 次/每秒并发请求，如果总请求量超过该限定，通用版，系统会将请求自定进入排队系统队列中，按照先进先出规则依次返回数据。
接口标识：
接口地址：点击获取key和secret
返回格式： json
请求方式： HTTP HTTPS GET
请求示例：Request address://api.onebound.cn/taobao/api_call.php?num_iid=520813250866&is_promotion=1&api_name=item_get&lang=zh-CN&key=<您自己的apikey>&secret=<您自己的secret>
参数说明：num_iid:淘宝商品ID
is_promotion:是否获取取促销价

商品详情接口返回值说明 :

num_iid Bigint 545828993398 宝贝ID
title String 三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮 宝贝标题
desc_short String 商品简介
promotion_price Int 优惠价
price Float 25.8 价格
total_price Float 0
suggestive_price Float 0
orginal_price String 25.80 - 91.80 原价
nick String 欢乐购客栈lxq73061 掌柜昵称
num Int 3836 库存
min_num Int 0 最小购买数
detail_url String http://item.taobao.com/item.htm?id=545828993398 宝贝链接
picurl String //gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX!!2596264565.jpg 宝贝图片
brand String 三刃木 品牌名称
brandId Int 8879363 品牌ID
rootCatId Int 50013886 顶级分类ID
cid Int 50014822
favcount Int 0
fanscount Int 0
crumbs Mix [] 导航菜单
created_time String
modified_time String
delist_time String
desc String
itemimgs Mix [{ "url": "//gd3.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX!!2596264565.jpg"} 商品图片
item_weight String
item_size String
location String 发货地
express_fee Float 0.00 快递费用
ems_fee Float EMS费用
post_fee Float 物流费用
shipping_to String 发货至
hasdiscount Boolean false 是否有优惠
video Mix [{"pic": "https://img.alicdn.com/imgextra/i4/1795410438/O1CN01ZORTQ01F6dyavtEur!!1795410438.jpg", "url": "//cloud.video.taobao.com/play/u/1795410438/p/1/e/1/t/8/218504165570.swf","type": "item"}] 商品视频
is_virtual String
sample_id String 商品风格标识ID
is_promotion Boolean false 是否促销
props_name String 1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子; 商品属性名
prop_imgs Mix {"propimg": [ {"properties": "1627207:1347647754", "url": "//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX!!2596264565.jpg"}]} 商品属性图片列表
property_alias String 20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色 商品属性别名
props Mix [{ "name": "产地","value": "中国" }] 商品详情
total_sold Int
skus Mix {"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "1627207:1347647754", "properties_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子", "quantity": "305", "sku_id": "3166598625985"}] 商品规格信息列表
seller_id Int 41572778 卖家ID
sales Int 138 销量
shop_id Int 59943521 店铺ID
props_list Mix {20509:9974422: 尺码:36} 商品属性
seller_info Mix {"nick": "欢乐购客栈", "city": null, "level": 12, "bail": "2000", "rate": 96, "score": "4.8", "delivery_score": "4.8", "item_score": "4.8", "shop_type": null, "user_num_id": "2596264565", "sid": "127203758", "title": "欢乐购客栈", "zhuy": "//shop127203758.taobao.com", "company_name": null, "menu": [] } 卖家信息
tmall Boolean false 是否天猫
error String 错误信息
warning String price_json error;skus miss; 警告信息
url_log Mix []
method String item_tmall:pget_item
promo_type String
propsimg Mix 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE!!2844096782.jpg 属性图片
shop_item Mix []
relate_items Mix []