展会门票预订

展会门票预订

用户在搜索动漫展、美术展览等展览需求时，搜索会展现展览购票卡片，提供的门票购买信息。

示意图

intent 上传接口

当前资源 intent 意图参数

key	类型	含义	示例/说明
city	string	展会城市	“北京”
name	string	展会名称	“游戏嘉年华”
type	string	展会类型	“动漫展”

当同时提供 intent.city和location.city时，优先使用 intent.city。因为 intent 内容是从用户搜索词中直接提取的。

可组成以下4种类型：1、展会城市+展会名称（city+name）eg：北京+游戏嘉年华

2、展会城市+展会类型（city+type）eg：北京+动漫展

3、展会名称（name）eg：游戏嘉年华

4、展会类型（type）eg：动漫展会

通过平台上传 txt 文件

资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上，txt 文件的具体要求参见接入流程-上传 Intent 数据。

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

{"city":"北京","name":"动漫游戏嘉年华","type":""}
{"city":"北京","name":"","type":"动漫展"}
{"city":"","name":"游戏嘉年华","type":""}
{"city":"","name":"","type":"漫展"}

通过开放 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	用户所在城市	“北京”/“杭州”，不含行政区划单位，例如”市”，可能为空

当前资源 srcid 资源编号

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

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

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

{
  "type": "sp_ala",
  "srcid": "48008",
  "surface": "mobile",
  "intent": {
    "city":"",
    "name":"动漫展",
    "type":""
  },
  "location": {
    "province":"浙江",
    "city": "杭州"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

当前资源分类的 data object 字段内容

key	类型	要求	说明
jump_url	string	必选	jump_url的说明：卡片标题的跳转链接，若卡片展现1个演出，跳转到该展会门票的购票页；若卡片展现大于1个演出，跳转到展会列表页
item_list	array	必选	展会列表，最少1个，最多3个
item_list.title	string	必选	单个左图右文的标题区域，超过两行截断
item_list.image	string	必选	单个展会的图片，分辨率要高于364*486px，比例长：宽=4:3
item_list.time	string	必选	展会持续时间，例如2019年4月16日-2019年4月30日
item_list.address	string	必选	地址，如”北京国家会展中心”
item_list.labels	array	可选	标签组，字符串数组，最多3个，每个标签不超过5个字
item_list.price	integer	必选	展会门票价格，默认单位是分，例如：4000，代表40元
item_list.url	string	必选	单个左图右文的跳转链接，例如/page/of/target
item_list.price_info	string	可选	已售信息，例如”已售3000”，可无该字段，有该字段时不可为空
item_list.button_url	string	必选	按钮跳转链接，例如/page/of/target
item_list.button_text	string	必选	按钮文案，例如”购买”，不超过2个字

举例：从 webhook 返回的 JSON (加密前)

{
    "status": 0,
    "msg": "string",
    "data": {
        "jump_url": "/page/of/target",
        "item_list": [{
            "title": "北京第五届Another World动漫游戏嘉年华秋季游园会",
            "image": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=2379086268,2130850456&fm=58",
            "time": "2019年4月16日-2019年4月30日",
            "address": "北京国家会展中心",
            "price": "4000",
            "url":"/page/of/target",
            "price_info":"月售3000",
            "button_url": "/page/of/target",
            "button_text": "购买",
            "labels": ["热销"]
        }]
    }
}

审核常见问题

intent的编写

展会门票预订的intent应该是开发者能提供展会门票预订服务的展会名称或展会类型。开发者可以对intent进行适当泛化，但卡片所提供的服务必须在展会门票预订服务的范围内，音乐会门票、景点门票、游乐场门票等均不算展会门票。举例如下：

intent	结论	说明
{“city”:”哈尔滨”,”name”:”哈尔滨第三届冰城国风动漫嘉年华暨西城红场周年庆典”,”type”:””}	低质	intent过于复杂，不符合用户搜索习惯
{“city”:”哈尔滨”,”name”:”动漫嘉年华”,”type”:””}	优质	符合用户搜索习惯
{“city”:”深圳”,”name”:”11.11光棍节主题演唱会”,”type”:””}	不通过	非展会门票预订服务范畴
{“city”:”贵阳”,”name”:”森田游戏体验馆”,”type”:””}	不通过	非展会门票预订服务范畴

我们非常鼓励开发者提交intent泛词来满足搜索用户的泛需求。例如：

{"city":"","name":"","type":"婚博会"}
{"city":"北京","name":"","type":"动漫展"}