智能小程序OPENCARD
开放类目

台风路径查询

用户在搜索台风路径查询相关query时（如 台风路径查询、台风实时查询等），搜索会展现相关query卡片，提供图片处理卡片，满足用户的需求。

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
toolname string 台风名称 “台风”

通过平台上传 txt 文件

资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上，txt 文件的每一行为一个 JSON 序列化消息。文件需要使用 UTF-8 无 BOM 编码，大小不超过 4M，超过 4M 的需要通过开放 API 上传。

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

1
2
3
{"toolname":"台风"}
{"toolname":"利奇马"}
{"toolname":"9号台风"}

通过开放 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 资源编号 5522

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

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

1
2
3
4
5
6
7
8
{
  "type": "sp_ala",
  "srcid": "5522",
  "surface": "mobile",
  "intent": {
    "toolname":"台风"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

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

key 类型 要求 说明
jump_url string 必选 卡片标题的跳转链接，跳转到展示台风路径的页面，例如 /page/of/target
image string 必选 台风路径图片链接，提供https开头的图片在线地址，像素1140*642，图片上清晰给出台风最新位置，图片实时更新
city_list array 可选，若选不可为空 台风经过的城市列表，展示2-4个城市信息
city_list.city_name string 可选，若选不可为空 城市名称，第1行为台风当前抵达城市，自上而下按时间顺序展现台风即将抵达的城市，需通过接口实时更新
city_list.arrival_time string 可选，若选不可为空 预计到达时间，例如”2019-08-11 23:00”
city_list.level string 可选，若选不可为空 级别，例如”13级”
additional_info string 可选，若选不可为空 数据源+更新时间，格式为 “数据源：中国天气网 更新时间: 2019-08-09 14:41”,更新时间指图片、表格等数据的更新时间

举例：从资源方服务器返回的 JSON (加密前)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

{
  "status": 0,
  "msg": "string",
  "data": {
    "jump_url": "/page/of/target",
    "image": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=2379086268,2130850456&fm=58",
    "city_list": [
      {
        "city_name": "台北",
        "arrival_time": "2019-08-11 23:00",
        "level": "12级"
      },
      {
        "city_name": "台北",
        "arrival_time": "2019-08-11 23:00",
        "level": "12级"
      },
      {
        "city_name": "台北",
        "arrival_time": "2019-08-11 23:00",
        "level": "12级"
      }
    ],
    "additional_info": "string"
  }
}

审核常见问题

卡片内容真实性、时效性

台风路径查询类目下的卡片内容需要着重注意符合真实性、时效性要求。卡片显示的城市及预计达到时间必须准确，若有变动必须及时更新。

证件照拍摄 曲谱
反 馈帮 助 回 到顶 部