智能小程序OPENCARD
开放类目

今日油价

用户在搜索“油价”、“92 号汽油”等关键词时，结果页会展现今日油价卡片。卡片摘要中展示四种燃油的实时单价和相对历史油价的涨跌值，以及资源方提供的其它油价相关服务的子链。点击子链可跳转至相应服务的落地页，点击卡片除子链外任意一处，则跳转至资源方提供的油价列表详情页。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
oil_price 　 string 服务类型 必选，提供的服务类型

通过平台上传 txt 文件

资源方需要将一个空的 intent通过 txt 文件上传到平台上，txt 文件的具体要求参见接入流程-上传 Intent 数据。

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

1
{ "oil_price": "" }

通过开放 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 用户表达的位置信息，应优先选用用户表达的位置信息进行检索 JSON 对象
query_info.query_province string 用户 Query 中指定的省份 “北京”/“河南”，不含行政区划单位，例如”市、省、自治区”，可能为空
query_info.query_city string 用户 Query 中指定的地级市 “北京”/“开封”，不含行政区划单位，例如”市”，可能为空
query_info.query_county string 用户 Query 中指定的县、区 “海淀”/“兰考”，不含行政区划单位，例如”县、区”，可能为空

注意：为满足用户的检索需求，资源方应优先使用query_info中的地理位置信息对结果进行筛选；当 query_info 无信息时，以location中的定位信息进行筛选以满足用户的潜在需求。

当前资源 srcid 资源编号

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

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "type": "sp_ala",
  "srcid": "48033",
  "surface": "mobile",
  "intent": { "oil_price": "" },
  "location": {
    "province": "浙江",
    "city": "杭州"
  },
  "query_info": {
    "query_province": "北京",
    "query_city": "北京",
    "query_county": "海淀"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

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

key 类型 要求 说明
jump_url string 必选 点击卡片除子链外任意一处的跳转链接，跳转至资源方的今日油价列表落地页。该字段需返回 H5 或智能小程序页面路径，例如“/page/of/target”；若跳转至 H5 或智能小程序首页（无路径），则需要返回“/?from=baidu”。
table_head string 必选 表头文案，日期+油价，如“12 月 23 日油价”
item_list array 必选 表格数据配置，最少 2 个，最多 25 个
item_list.oil_num string 必选 第 1 列：燃油标号，如“92 号汽油”
item_list.oil_price string 必选 第 2 列：今日油价数据，如“6.8 元/升”
item_list.price_change string 必选 第 3 列：今日油价相对历史油价的变化量，带符号，如“+0.04 元/升”
slink_list array 必选 子链+底部声明文案，子链最少 2 个，最多 5 个
slink_list.text string 必选 子链文案，资源方除油价查询外的其他主要服务名称，如“调价时间表”“油价趋势”“油价计算”等
slink_list.url string 必选 各子链的跳转链接，一般为其他主要服务的落地页链接。该字段需返回 H5 或智能小程序页面路径，例如“/page/of/target”；若跳转至 H5 或智能小程序首页（无路径），则需要返回“/?from=baidu”。
statement string 必选 底部声明，对数据来源和实际价值的说明，如“*数据为发改委最高零售价，实际油价请以加油站报价为准”

举例：从 webhook 返回的 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
28
29
30
31
32
33
34
35
36
{
  "status": 0,
  "msg": "",
  "data": {
    "jump_url": "/page/of/target?id=1",
    "table_head": "12月18日油价",
    "item_list": [
      {
        "oil_num": "92号汽油",
        "oil_price": "6.80元/升",
        "price_change": "+0.04元/升"
      },
      {
        "oil_num": "95号汽油",
        "oil_price": "7.24元/升",
        "price_change": "+0.05元/升"
      },
      {
        "oil_num": "98号汽油",
        "oil_price": "8.22元/升",
        "price_change": "+0.05元/升"
      },
      {
        "oil_num": "0号柴油",
        "oil_price": "6.47元/升",
        "price_change": "+0.04元/升"
      }
    ],
    "slink_list": [
      { "text": "调价时间表", "url": "/page/of/target" },
      { "text": "油价趋势", "url": "/page/of/target" },
      { "text": "油价计算", "url": "/page/of/target" }
    ],
    "statement": "*数据为发改委最高零售价，实际油价请以加油站报价为准。"
  }
}
投影仪计算器 体脂率计算器
反 馈帮 助 回 到顶 部