实时票房
用户在搜索实时票房时,搜索会展现“实时票房“卡片,提供在映电影的全国票房和排行榜等信息,满足用户的实时票房需求。
示意图
intent 上传接口
当前资源 intent 意图参数
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
query | string | 实时票房 | “实时票房””今日票房””最新票房” |
通过平台上传 txt 文件
资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 intent 数据。
当前资源分类 txt 上传文件内容示例如下:
- {"query":"今日票房"}
{"query":"实时票房"}
{"query":"最新票房"}
通过开放 API 上传
未开放
Webhook API
发送给 webhook 的请求
公共字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
type | string | 请求类型(大部分开发者可不关心) | 在小程序阿拉丁下永远为 “sp_ala” |
surface | string | 搜索场景(大部分开发者可不关心) | mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索 |
srcid | string | 资源编号 | 每个资源分类不同 |
intent | object | 搜索意图参数 | JSON 对象,每个资源分类不同 |
当前资源 srcid 资源编号
key | 类型 | 含义 | 设定 |
---|---|---|---|
srcid | string | 资源编号 | 5516 |
当前资源的 intent 参数参考上节 “intent 上传接口“。
举例:发送给 webhook 的 JSON (解密后)
- {
"type": "sp_ala",
"srcid": "5516",
"surface": "mobile",
"intent": {
"query": "全国今日实时票房"
}
}
从 webhook 返回的结果
外层通用数据字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
status | integer | 结果状态码,0 代表正确,1 代表无结果,2 代表请求参数错误,3 代表内部服务错误 | 0 |
msg | string | 出错消息,当非 0 时提供 | “” |
data | object | 要返回的资源数据内容 | JSON 对象,每个资源分类不同 |
当前资源分类的 data
object 字段内容
key | 类型 | 要求 | 说明 |
---|---|---|---|
jump_url | string | 必选 | 卡片标题的跳转链接,跳转到电影票房列表页 |
total_count | string | 必选 | 全国今日实时票房数据,默认单位「万」,保留两位小数 |
info | string | 必选 | 全国今日票房定义说明 |
update_info | string | 必选 | 数据更新信息,格式为”数据来源:猫眼专业版 数据更新时间:yy-mm-dd hh:mm:ss” |
rank_list | array | 必选 | 票房排名列表,显示前5名 |
rank_list.rank | integer | 必选 | 排名,例如”1” |
rank_list.name | string | 必选 | 电影名称 |
rank_list.count | string | 必选 | 实时票房数量,默认单位「万」,保留两位小数 |
rank_list.ratio | string | 必选 | 实时票房占比,保留一位小数 |
activity_text | string | activity运营区域整体可选,选后不可为空 | 电影运营位文案 |
activity_label | string | activity运营区域整体可选,选后不可为空 | 电影运营位标签,标签只能有1个,1-3个字 |
activity_url | string | activity运营区域整体可选,选后不可为空 | 电影运营位标签跳转路径 |
举例:从 webhook 返回的 JSON (加密前)
- {
"status": 0,
"msg": "",
"data": {
"total_count": "7887.19万",
"info": "全国今日实时票房数据 ",
"update_info": "数据来源:猫眼专业版 数据更新时间:2019-05-18 12:45:51",
"rank_list": [
{
"rank": "1",
"name": "阿拉丁",
"count": "2357.79万",
"ratio": "48.6%"
},
{
"rank": "2",
"name": "大侦探皮卡丘",
"count": "1299.59万",
"ratio": "23.8%"
},
{
"rank": "3",
"name": "调音师",
"count": "1256.13万",
"ratio": "21.2%"
}
{
"rank": "4",
"name": "罗小黑战记",
"count": "299.59万",
"ratio": "2.8%"
}
{
"rank": "5",
"name": "攀登者",
"count": "156.13万",
"ratio": "1.2%"
}
],
"activity_text": "百度观影团,邀请你免费看电影",
"activity_label": "惠",
"activity_url": "page/of/target",
"jump_url": "/path/to/page3"
}
}