API获取淘宝商品评论接口返回值说明

78 阅读2分钟

​         伴随着社交网络、大数据、云计算和搜索引擎等互联网应用技术的快速发展,各类应用软件的规模在日益庞大,我们需要把复杂系统划分成小的组成部分,因此编程接口的设计就显得十分重要。程序设计的实践中,编程接口的设计首先要使系统的职责得到合理划分,良好的接口设计可以降低系统各部分的相互依赖,提高组成单元的内聚性,降低组成单元间的耦合程度,从而提高系统的维护性和扩展性。 

1、公共参数

请求地址: console.open.onebound.cn/console/ind…

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[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简体中文
versionStringAPI版本

2、请求参数

请求参数:num_iid=71619129750&page=1

参数说明:item_id:商品ID
page:页数

3、响应参数

名称类型是否隐私示例值描述
itemsitems[]获得JD商品评论
rate_contentString这个帆布鞋的款式挺不错的,穿着也很百搭,做工很精细。!评论内容
rate_dateDate2020-07-16 17:04:45评论日期
picsMIX["//img30.360buyimg.com/n0/s128x96_jfs/t1/143538/26/2997/98915/5f10182dE075cf6f4/3893a6ebd54bf20b.jpg"]评论图片
display_user_nickStringj***X买家昵称
auction_skuString颜色:白色(加绒);尺码:2XL评论商品属性
add_feedbackString衣服面料很好 穿起来很舒服 衣服挺合适的!追评内容

4、请求示例 

<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 http://api-gw.onebound.cn/taobao/demo/sdk2020/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" =>"jd",
	                "api_name" =>"item_review",
	                "api_params"=>array (
  'num_iid' => '71619129750',
  'page' => '1',
)
                )
            );
 var_dump($api_data);
?>

5、响应示例

{
	"items": {
		"totalpage": "100",
		"total_results": "0",
		"page_size": 10,
		"page": "1",
		"item": [
			{
				"rate_content": "鞋子的版型很好看,价格也很便宜,穿上舒适透气,非常的喜欢,值得购买",
				"rate_date": "2020-07-16 17:04:45",
				"pics": [
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/143538/26/2997/98915/5f10182dE075cf6f4/3893a6ebd54bf20b.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/126308/37/7305/88222/5f10182dE2ed282fb/cfebb2e627fe3be4.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/123576/17/7322/100064/5f10182dE90877815/bb5f985a08987bc6.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/133271/17/4481/244268/5f10182dEd8ecc049/555eaa30d3599158.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/146490/36/3038/90958/5f10182dE065f71fd/12bb1e78f59309d7.jpg"
				],
				"display_user_nick": "j***X",
				"auction_sku": "MX-D01黑色(女)",
				"add_feedback": ""
			},
			{
				"rate_content": "鞋子收到了,特别舒服的一款帆布鞋,大小合适喜欢",
				"rate_date": "2020-07-20 18:14:39",
				"pics": [
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/118301/23/12855/72815/5f156e8fEa83416e3/f92e7f5b823c8a70.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/135616/29/4848/72074/5f156e8fEc82a7d80/6484851d44574830.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/148932/1/3387/69784/5f156e8fE7ba78e9d/7b61ee6327626d78.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/150109/36/3353/66120/5f156e8eE82e25eaf/9055b98faf6a044d.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/118412/31/12839/72815/5f156e8fE721e7bfd/327582fa5d9a25b3.jpg"
				],
				"display_user_nick": "j***y",
				"auction_sku": "MX-D01黑色(女)",
				"add_feedback": ""
			},
			{
				"rate_content": "东西非常不错 颜值很高很满意  搭配上牛仔裤在夏天穿 上身白体桖  一股浓郁的学院风扑面而来  年轻了十几岁",
				"rate_date": "2020-07-25 22:09:33",
				"pics": [
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/126821/34/7944/185434/5f1c3d1dE11aea5ec/689c14ef4399a439.jpg"
				],
				"display_user_nick": "三***容",
				"auction_sku": "YC-X-188米色(女)",
				"add_feedback": ""
			},
			{
				"rate_content": "这个帆布鞋的款式挺不错的,穿着也很百搭,做工很精细。",
				"rate_date": "2020-07-20 00:01:00",
				"pics": [
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/119504/13/11389/520508/5f1581faEf69c5854/2377fb2e01fc79e2.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/135899/37/4958/566205/5f1581faEc5f67e4c/1bd719364ac26276.jpg",
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/110797/21/15353/558212/5f1581fbE98486508/98667557f6b47c31.jpg"
				],
				"display_user_nick": "j***y",
				"auction_sku": "MX-D01黑色(女)",
				"add_feedback": "很有个性的一款鞋子,穿的舒适,样子新颖,质量也很好。"
			},
			{
				"rate_content": "这个鞋子我非常的喜欢,而且穿着特别的舒服,搭配起衣服来也特别的百搭。非常值得购买的一款鞋子。",
				"rate_date": "2020-09-16 09:18:43",
				"pics": [
					"//img30.360buyimg.com/n0/s128x96_jfs/t1/120503/26/12622/88927/5f6167efE6c9ef8ae/6fdeb847965a9acf.jpg"
				],
				"display_user_nick": "j***s",
				"auction_sku": "YC-X-188黑色(女)",
				"add_feedback": ""
			},
			{
				"rate_content": "鞋子穿着很舒服,用来搭配长裙或者是棉麻裤,都很好看,而且很合脚,走起路来一点都不会累。",
				"rate_date": "2020-07-17 17:48:04",
				"pics": [],
				"display_user_nick": "j***l",
				"auction_sku": "MX-D01黑色(女)",
				"add_feedback": ""
			}
		]
	},
	"secache": "8e3404bdf02f989d0e3164490e3945a2",
	"secache_time": 1615366119,
	"secache_date": "2021-03-10 16:48:39",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:21 max:10000",
	"execution_time": 0.854,
	"server_time": "Beijing/2021-03-10 16:48:39",
	"client_ip": "106.6.35.144",
	"call_args": {
		"num_iid": "71619129750",
		"data": "1",
		"page": 1
	},
	"api_type": "jd",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "3.15MB",
	"request_id": "gw-3.604887e6dc512"
}