点击众荟数据智能平台介绍页面下方的“立即体验”按钮,根据页面提示信息填写基本资料,提交后我们会有专门的市场人员与您联系。
为提升个性化服务质量,在您提供基本资料后,市场人员将会以电话或邮件的方式与您沟通确认详细需求。
我们为您提供了免费的测试次数,在您正式使用申请的API前,可与市场人员沟通获取免费额度。
在填写基本资料后,我们的市场人员将与您沟通需要申请的API列表,具体包括:调用方式、价格以及合同内容等,如确定合作意向,双方将签订纸质合同。
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| query | true | string | 请求翻译query |
| from | true | string | 翻译源语言 |
| to | true | string | 译文语言 |
返回结果字段说明:
| 返回值字段 | 类型 | 字段说明 |
|---|---|---|
| status | int | 返回状态码 |
| msg | string | 接口返回信息 |
| from | string | 翻译源语言 |
| to | string | 译文语言 |
| trans_result | string | 翻译结果 |
| src | string | 原文 |
语言列表:
| 语言简写 | 名称 |
|---|---|
| zh | 中文 |
| en | 英文 |
| ja | 日文 |
| ko | 韩文 |
支持的翻译源语言:中文、英文、日文、韩文
支持的译文语言:中文
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de&hotelid
query:The employees very friendly, and the place clean, comfortable, close
to
the Disney.
from:en
to:zh
请求示例表示,将“The employees very friendly, and the place clean, comfortable, close to the Disney.”从英文翻译到中文。
返回示例:
{
"msg": "online test",
"status": 0,
"result": {
"from": "en",
"to": "zh",
"src": " The employees very friendly, and the place clean, comfortable, close to the Disney. ",
"trans_result": "服务员态度都蛮和蔼可亲的,而且房间卫生做得很彻底很干净,酒店非常的舒适。"
}
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 授权码,邮件单独发送 |
| cardno | true | string | 加密后的用户手机号 |
返回结果字段说明:
| 返回值类型 | 类型 | 字段说明 |
|---|---|---|
| status | int | 状态码,非空 |
| msg | string | 状态额外信息,默认为空 |
| result | object | 用户标签对象,如未找到该用户,该字段为空; 该对象详细字段信息见下表。 |
用户标签对象说明:
| 字段名 | 类型 | 字段说明 |
|---|---|---|
| city | string | 所属城市名称 |
| device_type | string | 设备类型 |
| consume_type | string | 消费类型 |
| order_source | string | 购买渠道 |
| order_source_prefer | string | 喜欢的购买渠道 |
| pay_type | string | 支付方式 |
| pay_type_prefer | string | 喜欢的支付方式 |
| travel_time | string | 出行时间 |
| travel_time_prefer | string | 喜欢的出行时间 |
| travel_days | string | 出行天数 |
| is_breakfast | string | 是否订过早餐 |
| bed_type | string | 订过的床型 |
| bed_type_prefer | string | 喜欢的床型 |
| is_price_sensitive | string | 是否价格敏感 |
| price_sensitive | string | 价格敏感度 |
| max_price | string | 最大消费价格 |
| min_price | string | 最低消费价格 |
| avg_price | string | 平均消费价格 |
| activeclass | string | 用户活跃度 |
| hotel_type_prefer | string | 喜欢的酒店类型 |
| consume_ability | string | 消费能力 |
| customer_value | string | 客户价值 |
| avg_roomnum | string | 平均入住间数 |
使用示例
加密后的手机号码18d1384257076f94ad20ab51ce6b8b43
返回示例:
{
status: 0,
msg: "",
result: {
user_profile: [
{
city: "合肥"
},
{
device_type: "iPhone "
},
{
consume_type: [
"购买过国内酒店",
"购买过酒店"
]
},
{
order_source: [
"通过app预订过"
]
},
{
order_source_prefer: ""
},
{
pay_way: [
"通过现付预订过",
"通过预付预订过"
]
},
{
pay_way_prefer: ""
},
{
travel_time: [
"工作日出行"
]
},
{
travel_time_prefer: [
"偏好假期出行"
]
},
{
travel_days: "出游天数1-2天"
},
{
is_breakfast: "从未订过早餐"
},
{
bed_type: [ ]
},
{
bed_type_prefer: ""
},
{
is_price_sensitive: "价格不敏感用户"
},
{
price_sensitive: "低"
},
{
max_price: "500-1000"
},
{
avg_price: "500以内"
},
{
min_price: "150-300"
},
{
activeclass: "低"
},
{
hotel_type_prefer: "偏好经济酒店"
},
{
consume_ability: "中"
},
{
customer_value: "低"
},
{
avg_roomnum: "低"
}
]
}
请求参数说明:
| 名称 | 必选 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| access_token | true | 无 | string | 分配的授权码 |
| hotelid | true | 无 | int | 酒店ID |
| lnum | false | 3 | int | 返回长标签个数 |
| lmin | false | 0 | int | 长标签最短字数 |
| lmax | false | 100 | int | 长标签最长字数 |
| snum | false | 3 | int | 返回短标签个数 |
| smin | false | 0 | int | 短标签最短字数 |
| smax | false | 20 | int | 短标签最长字数 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| status | int | 返回状态码 |
| msg | string | 接口返回提示信息 |
| hotelid | int | 酒店ID |
| tag | string | 特色标签 |
| score | float | 标签分数 |
使用示例
通过HTTP请求的GET方式。调用者通过在HTTP请求中指定参数(hotelid,lnum,snum)来获取匹配结果。
http://api.jointwisdom.cn/route/review/hotel_tags?access_token=ccca1eca2d5724a0f55fad4fa0f829de&hotelid=1217385&lnum=2&snum=2
该请求表示: 请求调用酒店画像接口服务。需查询的酒店id为1217385,请求2个长标签(即特色标签)以及2个短标签(即维度标签)。
返回示例:
{
status: 0,
msg: "",
result:
{
hotelid: 1217385,
result:
[
{
tag: "地理位置相当理想的一家客栈",
score: 0.630952
},
{
tag: "可以叫酒店老板帮忙租车",
score: 0.623077
},
{
tag: "客房设施不错",
score: 0.986603
},
{
tag: "停车场很好",
score: 0.981161
}
]
}
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| hotelname | true | string | 酒店名称 |
| num | false | int | 匹配酒店个数 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| hotelid | int | 酒店ID |
| hotelname | string | 酒店名称 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
hotelname:温都水城
num:3
返回示例:
{
msg : "online test",
status : 0,
result :
{
hotelname : "温都水城",
result :
[
{
hotelid : 6951527,
hotelname : "温都水城"
} ,
{
hotelid : 427267,
hotelname : "北京温都水城"
} ,
{
hotelid : 6931755,
hotelname : "丹东凤城市温都水城"
}
]
}
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| hotel_id | true | int | 酒店ID |
| start_date | true | string | 开始日期 |
| end_date | true | string | 结束日期 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| star | double | 星级比例 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
hotel_id:367605
start_date:20170501
end_date:20170531
返回示例:
{
"msg": "",
"status": 0,
"result":
{
"0": 0.024793388429752,
"2": 0.52479338842975,
"3": 0.23553719008264,
"4": 0.057851239669421,
"5": 0.15702479338843
}
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| hotel_id | true | int | 酒店ID |
| start_date | true | string | 开始日期 |
| end_date | true | string | 结束日期 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| travel_intent | double | 出行目的比例 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
hotel_id:367605
start_date:20170501
end_date:20170531
返回示例:
{
"msg": "",
"status": 0,
"result":
{
"朋友出游": 0.2,
"其它": 0.2,
"商务出差": 0.4,
"情侣出游": 0.2
}
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| hotel_id | true | int | 酒店ID |
| start_date | true | string | 开始日期 |
| end_date | true | string | 结束日期 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| praise_ratio | double | 好评率 |
| praise_rank | double | 好评排名 |
| review_count | int | 点评数 |
| praise_increase | double | 点评同比增长率 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
hotel_id:367605
start_date:20170501
end_date:20170531
返回示例:
{
"msg": "",
"status": 0,
"result":
{
"review_increase": -0.64285714285714,
"review_count": 5,
"praise_ratio": 0.33333333333333,
"praise_rank": 0.014157014157014
}
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| city | true | string | 城市名称 |
| grid_id | true | string | 网格ID |
| date_month | true | string | 年月 |
| outFields | true | string | 返回数据类型 |
| f | true | string | 返回数据格式 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| city | string | 城市名称 |
| grid_id | string | 网格ID |
| fee1 | string | 50以下(话费,人民币) |
| fee2 | string | 50-100 |
| fee3 | string | 100-150 |
| fee4 | string | 150-200 |
| fee5 | string | 200以上 |
| date_month | string | 年月 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
city:maoming
grid_id:51000001
date_month:201703
outFields:city,grid_id,fee1,fee2,fee3,fee4,fee5,date_month
f:pjson
返回示例:
"features":
[
{
"attributes":
{
"city": "maoming",
"grid_id": 51000001,
"fee1": "56.35%",
"fee2": "22.8%",
"fee3": "11.76%",
"fee4": "3.42%",
"fee5": "5.67%",
"date_month": "201703"
}
}
]
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| city | true | string | 城市名称 |
| grid_id | true | string | 网格ID |
| date_month | true | string | 年月 |
| outFields | true | string | 返回数据类型 |
| f | true | string | 返回数据格式 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| city | string | 城市名称 |
| grid_id | string | 网格ID |
| male | string | 男 |
| female | string | 女 |
| date_month | string | 年月 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
city:maoming
grid_id:51000001
date_month:201703
outFields:city,grid_id,male,female,date_month
f:pjson
返回示例:
"features":
[
{
"attributes":
{
"city": "maoming",
"grid_id": 51000001,
"male": "54.21%",
"female": "45.79%",
"date_month": "201703"
}
}
]
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| city | true | string | 城市名称 |
| grid_id | true | string | 网格ID |
| date_month | true | string | 年月 |
| outFields | true | string | 返回数据类型 |
| f | true | string | 返回数据格式 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| city | string | 城市名称 |
| grid_id | string | 网格ID |
| age1 | string | 18岁及以下 |
| age2 | string | 19-24岁 |
| age3 | string | 25-29岁 |
| age4 | string | 30-34岁 |
| age5 | string | 35-39岁 |
| age6 | string | 40-44岁 |
| age7 | string | 45-49岁 |
| age8 | string | 50-54岁 |
| age9 | string | 55-59岁 |
| age10 | string | 60岁及以上 |
| date_month | string | 年月 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
city:maoming
grid_id:51000001
date_month:201703
outFields:city,grid_id,age1,age2,age3,age4,age5,age6,age7,age8,age9,age10,date_month
f:pjson
返回示例:
"features":
[
{
"attributes":
{
"city": "maoming",
"grid_id": 51000001,
"age1": "12.17%",
"age2": "18.55%",
"age3": "13.17%",
"age4": "8.62%",
"age5": "8.33%",
"age6": "9.63%",
"age7": "8.74%",
"age8": "6.14%",
"age9": "3.19%",
"age10": "11.46%",
"date_month": "201703"
}
}
]
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| city | true | string | 城市名称 |
| grid_id | true | string | 网格ID |
| date_month | true | string | 年月 |
| outFields | true | string | 返回数据类型 |
| f | true | string | 返回数据格式 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| objectid | string | 标识ID |
| city | string | 城市名称 |
| grid_id | string | 网格ID |
| day_all | string | 每日总人流量 |
| day_visit | string | 每日到访人流量 |
| stay1 | string | 停留小于1小时人数 |
| stay2 | string | 停留1-3小时人数 |
| stay3 | string | 停留3-6小时人数 |
| stay4 | string | 停留6-9小时人数 |
| stay5 | string | 停留大于9小时人数 |
| date_month | string | 年月 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
city:maoming
grid_id:51000001
date_month:201703
outFields:*
f:pjson
返回示例:
"features":
[
{
"attributes":
{
"objectid": 1000001,
"city": "maoming",
"grid_id": 51000001,
"day_all": 4856,
"day_visit": 794,
"stay1": 943,
"stay2": 990,
"stay3": 1282,
"stay4": 983,
"stay5": 2150,
"date": "20170301"
}
}
]
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| word | true | string | 请求的词语 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| word | string | 联想词 |
| score | float | 联想激活分 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
word:酒店
返回示例:
{
"msg": "online test",
"status": 0,
"result": [
{
"word": "宾馆",
"score": 0.6794588
},
{
"word": "饭店",
"score": 0.5456176
}
]
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| input | true | string | 被分析的文本 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| word | string | 词语 |
| pos | string | 词性 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
input:前台小王态度好!
返回示例:
{
"msg": "online test",
"status": 0,
"result": [
{
"word": "前台",
"pos": "n"
},
{
"word": "小王",
"pos": "nr"
},
{
"word": "态度",
"pos": "n"
},
{
"word": "好",
"pos": "a"
},
{
"word": "!",
"pos": "w"
}
]
}
请求参数说明:
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | true | string | 分配的授权码 |
| Review | true | string | 中文文本 |
返回结果字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| result | string | 分词后的文本 |
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
Review:附近有地铁站,出酒店坐出租车方便。房间内非常安静,服务非常贴心,有私人定制的感觉,下次来仍会选择
返回示例:
{
"msg": "online test",
"status": 0,
"result": "附近 有 地铁站 , 出 酒店 坐 出租车 方便 。 房间内 非常 安静 , 服务 非常 贴心 , 有 私人 定制 的 感觉 , 下次 来 仍会选择"
}
A:我们需要您提供手机号、邮箱和公司信息做身份校验,在申请免费额度前,也需要与您签订正式合同。
A:我们会给您一个唯一的access_token,您在后续调用接口的时候会用到,同时还需要您提供调用接口服务器的外网IP地址,我们会将IP添加到白名单列表;不同API调用频率的限制不一样,具体请参见每个接口的详细说明文档。
A:支持http请求,具体API详细调用方式参见市场人员发送给您的接口说明文档。
A:是的。
A:我们提供的是通用接口,web、android、ios等等都可以使用。
| 错误码 | 类型 | 说明 |
|---|---|---|
| 1 | API网关 | 没有这个接口 |
| 2 | API网关 | 未输入access_token |
| 3 | API网关 | 接口暂不可用 |
| 4 | API网关 | 尚未获得该API权限 |
| 5 | API网关 | API使用次数不足 |
| 6 | API网关 | 旧API产品失效 |
| 7 | API网关 | API失效或超时 |
| 8 | API网关 | IP没有授权 |
| 9 | API网关 | 访问频率超过限制 |
| 10 | API网关 | 参数校验未通过 |
| 100以上 | API | 接口内部错误 |
错误码:100以下为API网关错误,100以上为API内部错误码
请求参数说明:
返回结果字段说明:
使用示例
access_token:ccca1eca2d5724a0f55fad4fa0f829de
Review:酒店很好,服务不错。
返回示例:
{ "msg": "online test", "status": 0, "result": { "Lan": "zh", "Segments": [ { "Polarity": 3, "Start": 0, "End": 4, "Aspects": [ "酒店" ] }, { "Polarity": 1, "Start": 5, "End": 9, "Aspects": [ "服务其他" ] } ] } }