淘宝一键铺货应用场景对接文档
测试方法（具体步骤请先查看文档：【 OAuth2.0接口对接》商品接口测试方法】
1.订购链接：
2.授权 拿到ssion_id
3.调用custom接口 免费注册获取key和secret
参数要传授权的session,参数和淘宝官方的一致 （如：上传商品接口文档https://open.taobao.com/api.htm?docId=22&docType=2 ）
4.示例（获取淘宝时间）
http://api.onebound.cn/taobao/api_call.php?lang=zh-CN&key=test&secret=&api=taobao.time.get&api_name=custom&session=授权的session
接口的其它参数参考开放平台的参数，如果有图片上传的可以用POST提交
部分接口对接过程
taobao.item.update 更新商品信息 【测试成功】
taobao.item.add 添加一个商品 【测试成功】
taobao.item.img.upload 添加商品图片 【测试成功】
taobao.item.img.delete 删除商品图片 【测试成功】
taobao.item.propimg.delete 删除属性图片【测试成功】
taobao.item.propimg.upload 添加或修改属性图片【测试成功】
taobao.item.delete 删除单条商品 【测试成功】
taobao.items.custom.get 根据外部ID取商品【*不明白什么是外部ID】
taobao.item.price.update 更新商品价格 【*使用替代接口】
taobao.miniapp.items.get 批量获取商品信息 【*使用替代接口】
taobao.item.seller.get 获取单个商品详细信息 【测试成功】
淘宝类目属性获取（规则获取）
taobao.itemcats.authorize.get（授权类目和品牌）
taobao.itemcats.get（可供发布的类目）
taobao.itemprops.get( 获取标准商品类目属性 )
taobao.itempropvalues.get( 获取标准类目属性值 )
//更新商品信息(包括图片)
api=taobao.item.update&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&fields=num_iid,title,price&num_iid=545828993398&title=万邦总经理书法签名 万邦助您事业腾飞 致力企业信息化国际化&image=https://gd3.alicdn.com/imgextra/i4/41572778/TB2m.Khg5pnpuFjSZFIXXXh2VXa_!!41572778.jpg&id=
//返回结果
{
"item_update_response":{
"item":{
"iid":"13232",
"num_iid":1489161932,
"modified":"2000-01-01 00:00:00"
}
}
}
//更新商品图片
api=taobao.item.img.upload&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&num_iid=545828993398&position=1&image=https://img.alicdn.com/tfscom/i4/108727117/TB2pkyPeAfb_uJjSsrbXXb6bVXa_!!108727117.jpg_360x360xzq90.jpg&id=888263315499&api_name=custom
//返回结果
{
"item_img_upload_response":{
"item_img":{
"url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg"
}
}
}
//删除商品图片
api=taobao.item.img.delete&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&num_iid=545828993398&id=888263315499
//返回结果
{
"item_img_delete_response": {
"item_img": {
"created": "2020-02-28 21:38:11",
"id": 888263315499
},
"request_id": "9p0v0p3bb8vz"
}
//获取分类属性
api=taobao.itemprops.get&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&cid=121408025
//返回结果
{
"itemprops_get_response": {
"item_props": {
"item_prop": [
{
"multi": false,
"must": false,
"name": "产地",
"pid": 21299,
"prop_values": {
"prop_value": [
{
"name": "不丹",
"vid": 4397591
}
//添加商品[网页/页面设计/源代码类目，无规格]
api=taobao.item.add&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&fields=num_iid,title,price&num_iid=21743135216&title=zencart国际化&image=https://gd3.alicdn.com/imgextra/i4/41572778/TB2m.Khg5pnpuFjSZFIXXXh2VXa_!!41572778.jpg&location[state]=浙江&location[city]=杭州&type=fixed&desc=描述内容&cid=50026519&num=1&stuff_status=new&stuff_status=new&price=1.2&sold_quantity=1
//返回结果
{
"item_add_response":{
"item":{
"iid":"13232",
"num_iid":1489161932,
"created":"2000-01-01 00:00:00"
}
}
}
//添加商品[书法类目]
api=taobao.item.add&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&fields=num_iid,title,price&num_iid=545828993398&title=万邦总经理书法签名 万邦助您事业腾飞 致力企业信息化国际化&image=https://gd3.alicdn.com/imgextra/i4/41572778/TB2m.Khg5pnpuFjSZFIXXXh2VXa_!!41572778.jpg&location[state]=浙江&location[city]=杭州&type=fixed&desc=描述内容&cid=121408025&num=1&stuff_status=new&stuff_status=new&price=1.2&props=21433:12202485;1627207:28320;10142888:21968;17293834:3229295;20608:20213;20603:22083606;34375:14863995&sku_properties=21433:12202485;1627207:28320;10142888:21968&sku_quantities=10&sku_prices=10.6
//返回结果
{
"item_add_response": {
"item": {
"created": "2020-02-29 10:11:09",
"iid": "613055906493",
"num_iid": 613055906493
},
"request_id": "nfe27adkvygx"
}
}
//修改属性图片
api=taobao.item.propimg.upload&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&num_iid=545828993398&properties=1627207:28320&image=https://gd3.alicdn.com/imgextra/i4/41572778/TB2m.Khg5pnpuFjSZFIXXXh2VXa_!!41572778.jpg
//返回结果
{
"item_propimg_upload_response": {
"prop_img": {
"created": "2020-02-28 21:45:55",
"id": 886951822373,
"url": "https://img.alicdn.com/bao/uploaded/i4/41572778/O1CN01Y059cx1WOMrAf11m8_!!41572778.jpg"
},
"request_id": "vl7zcpm36ygm"
}
//删除属性图片
api=taobao.item.propimg.delete&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&num_iid=545828993398&id=884238060003
//返回结果
{
"item_propimg_delete_response": {
"prop_img": {
"created": "2020-02-28 21:53:43",
"id": 884238060003
},
"request_id": "3ohsuubxcjc4"
//删除宝贝
api=taobao.item.delete&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&num_iid=613038218579
//返回结果
{
"item_delete_response": {
"item": {
"created": "2020-02-28 22:01:46",
"iid": "613038218579",
"num_iid": 613038218579
},
"request_id": "3qxg86c931hg"
}
//获取单个商品详细信息
api=taobao.item.seller.get&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&num_iid=545828993398&fields=title,price,num,props,skus,pic_url,nick
//返回结果
{
"item_seller_get_response": {
"item": {
"newprepay": "default",
"nick": "lxq73061",
"num": 492943,
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/41572778/O1CN01Zaft6j1WOMrApkjie_!!0-item_pic.jpg",
"price": "1.00",
"props": "20603:22083606;20608:20213;21433:12202485;34375:14863995;1627207:28320;1627207:30156;10142888:21968;17293834:3229295",
"skus": [],
"title": "万邦总经理书法签名 万邦助您事业腾飞 致力企业信息化国际化"
},
"request_id": "5g4szuwmpmc7"
}
//修改商品价格
api=taobao.item.update&session=6102828ac92b8d2d713364404a39941f8aab18e1fhj7fa041572778&cid=121408025&num_iid=545828993398&price=12&sku_prices=12&sku_properties=1627207:28320;10142888:21968;21433:12202485&sku_quantities=1000
//返回结果
{
"item_update_response": {
"item": {
"iid": "545828993398",
"num_iid": 545828993398
},
"request_id": "443jwtv015g4"
}
}
//- taobao.itemcats.authorize.get（授权类目和品牌）
api=taobao.itemcats.authorize.get&fields=brand.vid, brand.name&session=SESSION
//返回结果
{
"response": {
"itemcats_authorize_get_response": {
"seller_authorize": {
"xinpin_item_cats": []
},
"request_id": "5ljnti277pge"
}
}
}
//- taobao.itemcats.get（可供发布的类目）
api=taobao.itemcats.get&parent_cid=0&session=SESSION
//返回结果
{
"response": {
"item_cats": {
"item_cat": [
{
"cid": "121266001",
"is_parent": "true",
"name": "众筹",
"parent_cid": "0"
},
{
"cid": "120886001",
"is_parent": "true",
"name": "公益",
"parent_cid": "0"
},
{
"cid": "98",
"is_parent": "true",
"name": "包装",
"parent_cid": "0"
},
{
"cid": "120950002",
"is_parent": "true",
"name": "天猫点券",
"parent_cid": "0"
}
]
},
"request_id": "5i4l7eivjm4w"
}
//- taobao.itemprops.get( 获取标准商品类目属性 )
api=taobao.itemprops.get&cid=1512&fields=cid,pid,prop_name,vid,name,name_alias,status,sort_order&session=SESSION
//返回结果
{
"response": {
"itemprops_get_response": {
"item_props": {
"item_prop": [
{
"name": "品牌",
"pid": 20000,
"sort_order": 1,
"status": "normal"
},
{
"name": "CPU品牌",
"pid": 139248429,
"sort_order": 2,
"status": "normal"
},
{
"name": "上市时间",
"pid": 148784156,
"sort_order": 3,
"status": "normal"
},
{
"name": "产品名称",
"pid": 148930449,
"sort_order": 4,
"status": "normal"
},
{
"name": "屏幕尺寸",
"pid": 148794100,
"sort_order": 5,
"status": "normal"
}
]
},
"request_id": "52u3hgmavynr"
}
}
//- taobao.itempropvalues.get( 获取标准类目属性值 ) 要从上一步获取pvs值
api=taobao.itempropvalues.get&cid=1512&pvs=20000;148794100&fields=cid,pid,prop_name,vid,name,name_alias,status,sort_order&session=SESSION
//返回结果
{
"response": {
"itempropvalues_get_response": {
"prop_values": {
"prop_value": [
{
"cid": 1512,
"name": "360",
"name_alias": "360",
"pid": 20000,
"prop_name": "品牌",
"sort_order": -1,
"status": "normal",
"vid": 3253280
},
{
"cid": 1512,
"name": "8848",
"name_alias": "8848",
"pid": 20000,
"prop_name": "品牌",
"sort_order": -1,
"status": "normal",
"vid": 3378431
}
]
},
"request_id": "uyczz0j1ofbm"
}
}