智能小程序OPENCARD
开放类目

租车服务

用户搜索『租车』、『北京租车”』等存在租车需求 query;当没有指定城市的时候,卡片根据用户定位展现相应卡片内容,并跳转到的用户所在地的落地页。当搜索词指定城市的时候并提供租车服务,需要根据下发的城市数据定向调整卡片文案展现和跳转落地页。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
rent_car string 上传一个空 intent “”

通过平台上传 txt 文件

资源方 txt 文件上传到平台上,txt 文件内容内只需要包括一个 intent,该 intent 为空即可,txt 文件的具体要求参见接入流程-上传 Intent 数据

当前资源分类 txt 上传文件内容示例如下:

1
{"rent_car":""}

通过开放 API 上传

详细接入方式参见 API 上传方式

Webhook API

发送给 webhook 的请求

公共字段

key 类型 含义 示例/说明
type string 请求类型 在小程序阿拉丁下永远为 “sp_ala”
surface string 搜索场景 mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索
srcid string 资源编号 每个资源分类不同
intentrent_car object 搜索意图参数 JSON 对象,每个资源分类不同
location object 用户定位信息 JSON 对象
location.province string 用户所在省份 “北京”/“浙江”,不含行政区划单位,例如”市、省、自治区”,可能为空
location.city string 用户所在城市 “北京”/“杭州”,不含行政区划单位,例如”市”,可能为空
query_info object 用户表达的位置信息,应优先选用用户表达的位置信息进行检索 JSON 对象
query_info.query_province string 用户 Query 中指定的省份 “北京”/“河南”,不含行政区划单位,例如”市、省、自治区”,可能为空
query_info.query_city string 用户 Query 中指定的地级市 “北京”/“开封”,不含行政区划单位,例如”市”,可能为空
query_info.query_county string 用户 Query 中指定的县、区 “海淀”/“兰考”,不含行政区划单位,例如”县、区”,可能为空

当前资源 srcid 资源编号

key 类型 含义 设定
srcid string 资源编号 48047

当前资源的 intent 参数参考上节 “intent 上传接口“。

举例:发送给 webhook 的 JSON (解密后)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"type": "sp_ala",
"srcid": "48047",
"surface": "mobile",
"intent": {
"rent_car": ""
},
"location": {
"province": "浙江",
"city": "杭州"
},
"query_info": {
"query_province": "陕西",
"query_city": "西安",
"query_county": "碑林"
}
}

注:应优先使用 query_info 进行相应地域的筛选,“query_info”为空时再使用“location” 进行筛选。

从 webhook 返回的结果

外层通用数据字段

key 类型 含义 示例/说明
status integer 结果状态码,0 代表正确,1 代表无结果,
2 代表请求参数错误,3 代表内部服务错误
0
msg string 出错消息,当非 0 时提供 “”
data object 要返回的资源数据内容 JSON 对象,每个资源分类不同

webhook 返回的 JSON (加密前)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"status": 0,
"msg": "",
"data": {
"app_name": "一嗨租车",
"app_icon": "https://b.bdstatic.com/searchbox/mappconsole/image/20190624/ad0f7885-f63f-4f97-8732-4bfe161141f5.jpg",
"jump_url": "http://m.baidu.com",
"head_title": "租车服务平台",
"head_source": "一嗨租车",
"service_title": "北京租车服务",
"service_text": "新用户使用首日立减100元",
"service_isofficial": true
}
}

对开发者的提醒

开发者在开发时需要考虑以下四个问题:
1、应该充分理解用户定位信息和用户搜索词中城市信息的区别;
2、当用户搜索词没有指定城市信息的时候,可以根据用户定位进行判断,如用户在北京,service_title 文案可以展示『北京租车服务』;如无法提供该城市信息服务/没有获取用户信息,则展示默认文案;
3、当用户搜索词指定城市信息时,应该根据自身能力判断能否提供该城市的租车服务:如果可以提供,需要对 service_title 文案内容进行调整,如『北京租车服务』;如果不可以提供则不应该返回结果。
4、需要保证用户在小程序使用服务的全流程体验。

反 馈帮 助 回 到顶 部