智能小程序OPENCARD
开放类目

电影票房

用户在搜索某个电影的票房时，搜索会展现“电影票房“卡片，展现该电影的累计票房、上映时间、实时票房、票房排名、影片评分、数据更新时间等信息，满足用户的票房需求。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
movie string 电影名 “大侦探皮卡丘”

通过平台上传 txt 文件

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

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

1
2
3
{"movie":"大侦探皮卡丘"}
{"movie":"复联4"}
{"movie":"哥斯拉2"}

通过开放 API 上传

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

Webhook API

发送给 webhook 的请求

公共字段

key 类型 含义 示例/说明
type string 请求类型 在小程序阿拉丁下永远为 “sp_ala”
surface string 搜索场景 mobile: 支持小程序的移动搜索，web_h5: 支持 H5 的移动搜索
srcid string 资源编号 每个资源分类不同
intent object 搜索意图参数 JSON 对象，每个资源分类不同

当前资源 srcid 资源编号

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

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

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

1
2
3
4
5
6
7
8
{
  "type": "sp_ala",
  "srcid": "5517",
  "surface": "mobile",
  "intent": {
    "movie":"大侦探皮卡丘"
  }
}

从 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 必选 电影累计票房数据定义说明，例：复仇者联盟4累计票房
show_time string 必选 电影上映时间说明，格式为”yy-mm-dd 大陆上映”
realtime_count string 必选 电影实时票房数据，保留两位小数
rank string 必选 实时票房排名
activity_text string 可选，选后不可为空 电影运营位活动名称，15个字以内
activity_info string 可选，选后不可为空 电影运营位活动说明，15个字以内
activity_url string 可选，选后不可为空 电影运营位跳转路径
activity_image string 可选，选后不可为空 电影运营位海报图，大小：120*120
update_info string 必选 票房数据更新信息，格式为”数据来源：猫眼专业版 数据更新时间：yy-mm-dd hh:mm:ss”

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "status": 0,
  "msg": "",
  "data": {
    "url": "/path/to/page1",
    "total_count": "20.94亿",
    "info": "复仇者联盟4累计票房",
    "show_time": "2019-04-24大陆上映",
    "realtime_count": "190.09万",
    "rank": "1",
    "activity_text": "复仇者联盟4电影票购买",
    "activity_info": "8元电影票免费抢",
    "activity_url": "/path/to/page2",
    "activity_image": "https://example.com/img.jpg",
    "update_info": "数据来源：猫眼专业版 数据更新时间：2019-05-18 12:45:51",
  }
}

审核常见问题

卡片展现内容

电影票房类目卡片展现的内容需要符合以下几点要求：

  • 已经下映的老电影，可以没有实时票房及其排名数据，但是必须有总票房数据；
  • 在映电影，必须有总票房、实时票房及其排名数据，允许刚上映的电影有票房数据滞后的情况；
  • 未上映电影，可以暂无数据。
有声读物 实时票房
反 馈帮 助 回 到顶 部