为了进行此平台API的调用,首先我们需要做下面几件事情。
1、 获取一个KEY。
2、 参考API文档里的接入方式和示例。
3、查看测试工具是否有需要的接口,响应实例的返回字段是否符合参数要求。
4、利用平台的文档中心和API测试工具,对接口进行测试、程序获取。
更多API调用展示以及获取Key和secret请移步
https://console.open.onebound.cn/console/?i=Anzexi
以下是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版本 |
请求参数
请求参数:imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=
参数说明:imgid:图片地址(支持淘宝或天猫图片地址,外部地址先调用上传图片(upload_img)接口,返回图片地址)
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
响应参数
Version: Date:
请求示例
Curl PHP PHPsdk JAVA C# Python
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
响应示例
Request address:
https://api-gw.onebound.cn/taobao/item_search_img/?key=&
&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=&&lang=zh-CN&secret=
---------------------------------------
Result Object:
---------------------------------------
{
"items": {
"pagecount": 1,
"total_results": 60,
"real_total_results": 60,
"item": [
{
"title": "专业欧文精英袜篮球袜男中筒男高帮长筒高筒纯棉毛巾底加厚防滑袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01iXbKsi26m1XpFuT8k_!!3547947703.jpg",
"promotion_price": "17.90",
"price": "35.00",
"sales": 1,
"num_iid": "636331907048",
"post_fee": "0.00",
"sample_id": "",
"seller_nick": "比跃途运动袜业",
"is_tmall": "false",
"area": "广东 广州",
"detail_url": "//item.taobao.com/item.htm?id=636331907048",
"cid": null
},
{
"title": "Sports House运动之家中筒篮球袜男士实战精英袜专业透气运动袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01wvnxPN1s0TkX1vYL8_!!2206744855704.jpg",
"promotion_price": "33.80",
"price": "99.00",
"sales": 3,
"num_iid": "613356309153",
"post_fee": "0.00",
"sample_id": "",
"seller_nick": "sportshouse旗舰店",
"is_tmall": "false",
"area": "浙江 绍兴",
"detail_url": "//item.taobao.com/item.htm?id=613356309153",
"cid": null
},
{
"title": "st 2019 nba精英高帮篮球袜精英袜联名款毛巾底防滑缓震运动比赛",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01oVIXDB1aKTzJ7SIL8_!!2201451133311.jpg",
"promotion_price": "20.14",
"price": "41.10",
"sales": 1,
"num_iid": "624515685398",
"post_fee": "0.00",
"sample_id": "",
"seller_nick": "永邦体育馆",
"is_tmall": "false",
"area": "湖北 宜昌",
"detail_url": "//item.taobao.com/item.htm?id=624515685398",
"cid": null
},
{
"title": "St专业篮球袜精英篮球袜美国队中筒毛巾底男袜防臭吸汗加厚运动袜",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01JJ0Df91ynNswhTrvH_!!2212656286623.jpg",
"promotion_price": "21.80",
"price": "30.80",
"sales": 2,
"num_iid": "669956799574",
"post_fee": "0.00",
"sample_id": "",
"seller_nick": "Alano篮球袜馆",
"is_tmall": "false",
"area": "浙江 杭州",
"detail_url": "//item.taobao.com/item.htm?id=669956799574",
"cid": null
},
{
"title": "维动实战专业篮球袜子毛巾底高筒运动精英男中筒高帮长筒训练美式",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01uzLrJz2CO6cMXnnuX_!!3495438463.jpg",
"promotion_price": "13.80",
"price": "63.80",
"sales": 19247,
"num_iid": "659177978472",
"post_fee": "0.00",
"sample_id": "",
"seller_nick": "veidoorn维动旗舰店",
"is_tmall": "false",
"area": "江苏 扬州",
"detail_url": "//item.taobao.com/item.htm?id=659177978472",
"cid": null
},
{
"title": "NBA球员版stance篮球袜运动精英袜毛巾底实战加厚吸汗中高筒缓震",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN015eeDS41yyNMsbtMyE_!!2181686647.jpg",
"promotion_price": "24.00",
"price": "24.00",
"sales": 11,
"num_iid": "659528356583",
"post_fee": "0.00",
"sample_id": "",
"seller_nick": "名人运动袜铺",
"is_tmall": "false",
"area": "浙江 绍兴",
"detail_url": "//item.taobao.com/item.htm?id=659528356583",
"cid": null
},
{
"title": "维动实战专业篮球袜子毛巾底高筒运动精英男中筒高帮长筒训练美式",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01d6nRCE2CO6cTiJAFZ_!!3495438463.jpg",
"promotion_price": "13.80",
"price": "63.80",
"sales": 18340,
"num_iid": "658455580393",
"post_fee": "0.00",
"sample_id": "",
"seller_nick": "veidoorn维动旗舰店",
"is_tmall": "false",
"area": "江苏 扬州",
"detail_url": "//item.taobao.com/item.htm?id=658455580393",
"cid": null
},
{
"title": "stance篮球袜NBA球员联名斯坦斯359中筒实战加厚毛巾底运动袜559",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01YGfMiL1GINyG9fZnG_!!2212904250599.jpg",
"promotion_price": "18.00",
"price": "18.00",
"sales": 1,
"num_iid": "662989417477",
"post_fee": "15.00",
"sample_id": "",
"seller_nick": "三球袜业",
"is_tmall": "false",
"area": "浙江 杭州",
"detail_url": "//item.taobao.com/item.htm?id=662989417477",
"cid": null
},
{
"title": "ACE综合级_UZIS斗牛2.0篮球袜男高帮运动实战专业长中筒精英袜子",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01EO3ZnU24wtnFsEU9S_!