用户在搜索城市/目的地/景点 + 旅游相关字段时,搜索会展现“旅游线路“卡片,展示当前城市/目的地/景点 下的旅游产品。
示意图
intent 上传接口
当前资源 intent 意图参数
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
scenic_spot | string | 旅游目的地,支持省份/城市/地区/景点 等旅游目的地, 不能为空 | “云南” / “大西北” / “丽江” / “张家界” / “故宫” / “颐和园” |
type | string | 旅游类型 | “自由行” / “跟团游” |
通过平台上传 txt 文件
资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 intent 数据。
当前资源分类 txt 上传文件内容示例如下:
1 | {"scenic_spot":"北京","type":""} |
通过开放 API 上传
详细接入方式参见 API上传方式
Webhook API
发送给 webhook 的请求
公共字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
type | string | 请求类型 | 在小程序阿拉丁下永远为 “sp_ala” |
surface | string | 搜索场景 | mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索 |
srcid | string | 资源编号 | 每个资源分类不同 |
intent | object | 搜索意图参数 | JSON 对象,每个资源分类不同 |
location | object | 用户定位信息 | JSON 对象 |
location.province | string | 用户所在省份 | “北京”/“浙江”,不含行政区划单位,例如”市、省、自治区”,可能为空 |
location.city | string | 用户所在城市 | “北京”/“杭州”,不含行政区划单位,例如”市”,可能为空 |
query_info | object | 用户检索词信息 | |
query_info.query_city | string | 用户检索词中出现的出发城市 | 当用户检索词中包含出发城市,使用query_info.query_city做出发点筛选,若为空,使用location.city做出发点筛选 |
当前资源 srcid 资源编号
key | 类型 | 含义 | 设定 |
---|---|---|---|
srcid | string | 资源编号 | 48017 |
当前资源的 intent 参数参考上节 “intent 上传接口“。
举例:发送给 webhook 的 JSON (解密后)
注:以下发送的参数中location和query_info对象中的具体字段可能是空字符,开发者需要注意兼容,当为空时开发者可以根据具体情况返回默认值
1 | { |
从 webhook 返回的结果
外层通用数据字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
status | integer | 结果状态码,0 代表正确,1 代表无结果, 2 代表请求参数错误,3 代表内部服务错误 |
0 |
msg | string | 出错消息,当非 0 时提供 | “” |
data | object | 要返回的资源数据内容 | JSON 对象,每个资源分类不同 |
当前资源分类的 data
object 字段内容
key | 类型 | 要求 | 说明 |
---|---|---|---|
jump_url | string | 必选 | 卡片标题的跳转链接,跳转落地页必须符合 intent 体现的用户主需求 |
tag | array | 可选,选后不可为空 | 分类标签,tag 名称和连接的数组,最少 3 个,最多 3 个 |
tag.text | string | 必选 | Tag 字段,Tag 字段包括:「全部」、「跟团游」、「自由行」;首位 tag 必须满足 intent 体现的用户主需求 |
tag.url | string | 必选 | 点击 tag 后的跳转链接 |
item_list | array | 必选 | 左图右文列表数据,最少 1 个,最多 3 个 |
item_list.image | string | 必选 | 图片链接 |
item_list.grade_sales | array | 必选 | 文本数组:评分字段【5 分】& 已售量级【已售 4000】,字符串数组,最少 2 个,最多 2 个 |
item_list.feature_label | array | 必选 | 标签组:标签字段, 如:「亲子游」,字符串数组,最多 3 个 |
item_list.item_url | string | 必选 | 商品跳转链接 |
item_list.title | string | 必选 | 商品名称 |
item_list.price | integer | 必选 | 价格,默认单位是分(130000 = ¥ 1300) |
item_list.price_info | string | 必选 | 价格补充文案,例如:「元起」 |
label_text | string | 可选,选后不可为空 | 标签样例数据,如:「优惠」,例如:惠 |
ads_text | string | 可选,选后不可为空 | 活动字段样例数据,如:「云南线路游限时特惠」 |
ads_url | string | 可选 | 活动链接地址 |
举例:从 webhook 返回的 JSON (加密前)
1 | { |