根据用户的AppID返回特定目标的当天、近七天、近一年的各种信源的评价统计数量。数据采集的目标的ID请用户联系客服进行配置。
1、调用接口请求说明
需要向相应接口调用地址POST以下示例数据包:
{
"ref_date": "2017-08-14",
"scenic_id": "ID1"
}
参数说明
序号 |
参数 |
是否必须 |
说明 |
1 |
access_token |
是 |
调用接口凭证 |
2 |
ref_date |
是 |
获取的数据所属日期 |
3 |
scenic_id |
是 |
数据采集目标的ID字符串,如景区,需要提前联系客服获取 |
2、返回说明
正常情况下,返回下述JSON数据包:(以黄陵县景区为例)
{
"ref_date":"20170814",
"scenic_id":"ID1",
"scenic_name":"黄帝陵旅游区",
"stats_total":{ "total_1day":123,
"total_pos_1day":44,
"total_neg_1day":56,
"total_7day":2222,
"total_pos_7day":1111,
"total_neg_7day":1000,
"total_1year":123,
"total_pos_1year":44,
"total_neg_1year":56,
},
"stats_ctrip":{ "ctrip_1day":123,
"ctrip_pos_1day":44,
"ctrip_neg_1day":56,
"ctrip_7day":2222,
"ctrip_pos_7day":1111,
"ctrip_neg_7day":1000,
"ctrip_1year":123,
"ctrip_pos_1year":44,
"ctrip_neg_1year":56,
},
//以上为总计和携程的统计,后面还包括去哪儿(qunr),同城(tongcheng),美团
(meituan),途牛(tuniu),驴妈妈(lvmama)。以上数字仅作为举例参考。
}
参数说明
序号
参数
说明
1
ref_data
获取的数据所属日期
2
scenic_id
数据采集目标的ID字符串,如景区,需要提前联系客服获取
3
scenic_name
数据采集目标的中文名
4
stats_total
包含了总体评价的统计数据,stats_ctrip等为不同信息源的统计
5
total_1day
总体当日合计评价数据量
6
total_pos_1day
总体当日好评数据量
7
total_neg_1day
总体当日差评数据量
8
total_7day
总体近七日合计评价数据量
9
total_pos_7day
总体近七日好评数据量
10
total_neg_7day
总体近七日差评数据量
11
total_1year
总体近一年合计评价数据量
12
total_pos_1year
总体近一年好评数据量
13
total_neg1year
总体近一年差评数据量
14
ctrip_*_*
携程的某时间段某类评价数据量,以下以此类推
错误时会返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误)
{“errcode”:40013,”errmsg”:”invalid appid”}
3、返回码说明
序号 |
返回码 |
说明 |
1 |
-1 |
系统繁忙,此时稍候再试 |
2 |
0 |
请求成功 |
3 |
40001 |
AppSecret错误或者AppSecret不匹配,请开发者确认AppSecret的正确性 |
4 |
40002 |
请确保grant_type字段值为client_credential |
5 |
40006 |
scenic_id错误,请确认使用的AppID是否拥有对该scenic_id的访问权限 |
6 |
40007 |
ref_date错误,系统中无当日数据采集的记录。如需要请联系客服 |
7 |
40013 |
该AppID无效,请联系海鳗客服获取正确的APPID |
8 |
40014 |
Access_Token无效,请重新获取 |
9 |
40164 |
调用接口的IP地址不在白名单中,请在联系海鳗客服在接口IP白名单中进行设置 |
服务示例
http://<host:port>/v3/search/busline/byid?city=010&busIds=1100006301,1100006701&ak=<用户Key>
参数 | 值 | 备注 | 必选 |
---|