淘宝/天猫 API接口

_雨下整夜
93 阅读4分钟

欢饮使用淘宝API接口 product_add-卖家店铺添加宝贝

注册获取Key

公共参数：

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

请求参数：

post参数：sid=119e1dd5b87a48719b74619cdb84a286
post参数data示例:{ "sid":"18aad7fb3f33370a7b3131a15c6042ed", "data": { "category": "203301", "desc": { "data":[ { "type":"text","value":"商品图文" }, { "type":"image","value":"img.alicdn.com/imgextra/i4…" } ] }, "freight": 15, "image": [ "img.alicdn.com/imgextra/i3…", "img04.taobaocdn.com/tfscom/O1CN…" ], "scanMatched": "0", "shippingAddress": { "country":"中国", "province":"海南", "city":"三亚" }, "title": "测试商品勿拍20210521", "version": "0", "properties": {"props":[{"name":"FREE ARMY","nameAndValue":"FREE ARMY","pid":"20000","type":"norm","vid":"19512119","checked":"1"},{"checked":"1","name":"原创","pid":"12701698","type":"norm","vid":"3255109"},{"checked":"1","name":"影视","pid":"12701698","type":"norm","vid":"50301"},{"checked":"1","name":"游戏","pid":"12701698","type":"norm","vid":"3231231"},{"checked":"1","name":"14周岁以上","pid":"20017","type":"norm","vid":"81121134"},{"checked":"1","name":"上衣","pid":"20464","type":"norm","vid":"27824"},{"checked":"1","name":"定做","pid":"6724495","type":"norm","vid":"46875"}]}, "spec": {"skuList":[{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"90554","name":"桔色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"28332","name":"浅灰色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"30156","name":"浅绿色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"60092","name":"浅黄色","type":"norm"}],"price":"77.00","quantity":"10"}]}, "approveStatus": "onsale", "bizType": "knshop" } }

参数说明：sid是由buyer_token_create接口生成，取自下面的token值

响应参数：

Version: Date:

名称类型必须示例值描述
product_idString0645019884266成功的商品ID
createdString02021-05-25 10:54:40上传时间

请求示例：

<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 https://open.onebound.cn/help/demo/sdk/onebound-api-sdk.zip
include ("ObApiClient.php");

$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api-gw.onebound.cn/";
$obapi->api_urls = array("http://api-gw.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时，是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;

$api_data = $obapi->exec(
                array(
	                "api_type" =>"taobao",
	                "api_name" =>"product_add",
	                "api_params"=>array (
  'sid' => '20be2c52364d61aae178fa89caaf349a',
  'data' => '{
    "sid":"18aad7fb3f33370a7b3131a15c6042ed1",
    "data": {
        "category": "203301",
        "desc": {
            "data":[
                {
                    "type":"text","value":"商品图文"
                },
                {
                    "type":"image","value":"https://img.alicdn.com/imgextra/i4/6000000002211/O1CN01Vq8E5J1SCgMg1I7BF_!!6000000002211-0-itemtrans.jpg"
                }
            ]
        },
        "freight": 15,
        "image": [
            "https://img.alicdn.com/imgextra/i3/267485546/O1CN013Pb5ef1qq7BH7CluB_!!267485546.jpg",
            "http://img04.taobaocdn.com/tfscom/O1CN01kbvd6J1rDTROxLLaf_!!0-imgsearch.jpg","http://img04.taobaocdn.com/tfscom/TB1noQysyDsXe8jSZR0wu0K6FXa.png"
        ],
        "scanMatched": "0", 
        "shippingAddress": {
            "country":"中国",
            "province":"海南",
            "city":"三亚"
        },
        "title": "测试商品勿拍20210521", "version": "0",
        "properties": {"props":[{"name":"FREE ARMY","nameAndValue":"FREE ARMY","pid":"20000","type":"norm","vid":"19512119","checked":"1"},{"checked":"1","name":"原创","pid":"12701698","type":"norm","vid":"3255109"},{"checked":"1","name":"影视","pid":"12701698","type":"norm","vid":"50301"},{"checked":"1","name":"游戏","pid":"12701698","type":"norm","vid":"3231231"},{"checked":"1","name":"14周岁以上","pid":"20017","type":"norm","vid":"81121134"},{"checked":"1","name":"上衣","pid":"20464","type":"norm","vid":"27824"},{"checked":"1","name":"定做","pid":"6724495","type":"norm","vid":"46875"}]},
        "spec": {"skuList":[{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"90554","name":"桔色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"28332","name":"浅灰色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"30156","name":"浅绿色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"60092","name":"浅黄色","type":"norm"}],"price":"77.00","quantity":"10"}]},
        "approveStatus": "onsale", 
        "bizType": "knshop"
    }
}
',
)
                )
            );
 var_dump($api_data);
?>

万邦淘宝/天猫卖家店铺添加宝贝 API 返回值说明

product_add-卖家店铺添加宝贝 [查看演示] API测试工具 注册开通

onebound.taobao.product_add

公共参数

请求地址: api-gw.onebound.cn/taobao/prod…

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

请求参数

请求参数：
post参数：sid=119e1dd5b87a48719b74619cdb84a286
post参数data示例:{ "sid":"18aad7fb3f33370a7b3131a15c6042ed", "data": { "category": "203301", "desc": { "data":[ { "type":"text","value":"商品图文" }, { "type":"image","value":"img.alicdn.com/imgextra/i4…" } ] }, "freight": 15, "image": [ "img.alicdn.com/imgextra/i3…", "img04.taobaocdn.com/tfscom/O1CN…" ], "scanMatched": "0", "shippingAddress": { "country":"中国", "province":"海南", "city":"三亚" }, "title": "测试商品勿拍20210521", "version": "0", "properties": {"props":[{"name":"FREE ARMY","nameAndValue":"FREE ARMY","pid":"20000","type":"norm","vid":"19512119","checked":"1"},{"checked":"1","name":"原创","pid":"12701698","type":"norm","vid":"3255109"},{"checked":"1","name":"影视","pid":"12701698","type":"norm","vid":"50301"},{"checked":"1","name":"游戏","pid":"12701698","type":"norm","vid":"3231231"},{"checked":"1","name":"14周岁以上","pid":"20017","type":"norm","vid":"81121134"},{"checked":"1","name":"上衣","pid":"20464","type":"norm","vid":"27824"},{"checked":"1","name":"定做","pid":"6724495","type":"norm","vid":"46875"}]}, "spec": {"skuList":[{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"90554","name":"桔色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"28332","name":"浅灰色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"30156","name":"浅绿色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"60092","name":"浅黄色","type":"norm"}],"price":"77.00","quantity":"10"}]}, "approveStatus": "onsale", "bizType": "knshop" } }

参数说明：sid是由buyer_token_create接口生成，取自下面的token值

响应参数

Version: Date:

名称类型必须示例值描述
product_idString0645019884266成功的商品ID
createdString02021-05-25 10:54:40上传时间

请求示例

<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 https://open.onebound.cn/help/demo/sdk/onebound-api-sdk.zip
include ("ObApiClient.php");

$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api-gw.onebound.cn/";
$obapi->api_urls = array("http://api-gw.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时，是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;

$api_data = $obapi->exec(
                array(
	                "api_type" =>"taobao",
	                "api_name" =>"product_add",
	                "api_params"=>array (
  'sid' => '20be2c52364d61aae178fa89caaf349a',
  'data' => '{
    "sid":"18aad7fb3f33370a7b3131a15c6042ed1",
    "data": {
        "category": "203301",
        "desc": {
            "data":[
                {
                    "type":"text","value":"商品图文"
                },
                {
                    "type":"image","value":"https://img.alicdn.com/imgextra/i4/6000000002211/O1CN01Vq8E5J1SCgMg1I7BF_!!6000000002211-0-itemtrans.jpg"
                }
            ]
        },
        "freight": 15,
        "image": [
            "https://img.alicdn.com/imgextra/i3/267485546/O1CN013Pb5ef1qq7BH7CluB_!!267485546.jpg",
            "http://img04.taobaocdn.com/tfscom/O1CN01kbvd6J1rDTROxLLaf_!!0-imgsearch.jpg","http://img04.taobaocdn.com/tfscom/TB1noQysyDsXe8jSZR0wu0K6FXa.png"
        ],
        "scanMatched": "0", 
        "shippingAddress": {
            "country":"中国",
            "province":"海南",
            "city":"三亚"
        },
        "title": "测试商品勿拍20210521", "version": "0",
        "properties": {"props":[{"name":"FREE ARMY","nameAndValue":"FREE ARMY","pid":"20000","type":"norm","vid":"19512119","checked":"1"},{"checked":"1","name":"原创","pid":"12701698","type":"norm","vid":"3255109"},{"checked":"1","name":"影视","pid":"12701698","type":"norm","vid":"50301"},{"checked":"1","name":"游戏","pid":"12701698","type":"norm","vid":"3231231"},{"checked":"1","name":"14周岁以上","pid":"20017","type":"norm","vid":"81121134"},{"checked":"1","name":"上衣","pid":"20464","type":"norm","vid":"27824"},{"checked":"1","name":"定做","pid":"6724495","type":"norm","vid":"46875"}]},
        "spec": {"skuList":[{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"90554","name":"桔色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"28332","name":"浅灰色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"30156","name":"浅绿色","type":"norm"}],"price":"77.00","quantity":"10"},{"props":[{"pid":"134942334","vid":"3567560","name":"量身定制","type":"norm"},{"pid":"1627207","vid":"60092","name":"浅黄色","type":"norm"}],"price":"77.00","quantity":"10"}]},
        "approveStatus": "onsale", 
        "bizType": "knshop"
    }
}
',
)
                )
            );
 var_dump($api_data);
?>

响应示例：

{
        "data_from": "app",
        "product_id": "645019884266",
        "created": "2021-05-25 10:54:40",
        "error": "",
        "reason": "",
        "error_code": "0000",
        "cache": 0,
        "api_info": "today:32 max:10000",
        "execution_time": 1.112,
        "server_time": "Beijing/2021-05-25 10:54:40",
        "client_ip": "106.6.38.137",
        "call_args": [],
        "api_type": "taobao",
        "translate_language": "zh-CN",
        "translate_engine": "google_cn",
        "server_memory": "6.99MB",
        "request_id": "2.60ac66ef6bd95"
    }
```
```
avatar
文章
阅读
粉丝