智能小程序OPENCARD
开放类目

星座配对

用户在搜索星座配对时，搜索会展现“星座配对“卡片，提供星座配对指数等信息，满足用户的需求。

示意图

双星座配对

单星座配对

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
constell_a string 配对组合第一部分 “天蝎男”
constell_b string 配对组合第二部分 “双鱼女”

通过平台上传 txt 文件

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

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

1
2
3
4
{"constell_a":"天蝎","constell_b":"双鱼"}
{"constell_a":"天蝎男","constell_b":"双鱼女"}
{"constell_a":"天蝎","constell_b":""}
{"constell_a":"天蝎女","constell_b":""}

注意：以上 intent 组合分别在以下两类 query 下召回此卡片：

intent 组合 query 类型 举例
constell_a 上传实体名、constell_b 上传实体名 双星座配对需求 “天蝎双鱼配对”、“天蝎男和双鱼女”
constell_a 上传实体名、constell_b 为空 单星座配对需求 “天蝎座和什么星座最配”、“天蝎女和什么星座的男生配”

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

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

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

1
2
3
4
5
6
7
8
9
{
  "type": "sp_ala",
  "srcid": "5526",
  "surface": "mobile",
  "intent": {
    "constell_a": "天蝎男",
    "constell_b": "天秤女"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

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

key 类型 要求 说明
jump_url string 必选 点击卡片标题的跳转链接，跳转到展示星座配对详情的页面。双星座配对要求页面有对当前配对的详细分析；单星座配对要求页面展示该星座的最相配星座列表或排名，并附简要分析。例如：“/page/of/target”
tag_list array 必选 tag 数组
tag_list.text string 必选 双星座配对情况下，为星座配对组合，例如“双鱼女和天蝎男”；单星座配对情况下，为该星座的性别配置，如“天秤女”
tag_list.url array 必选 tag 的跳转链接，跳转到展示星座配对详情的页面。双星座配对要求页面有对双方配对指数的详细分析；单星座配对要求页面展示该星座多个相配星座的列表或排名，并附简要分析。例如：“/page/of/target”
score string 必选 双星座配对情况下，为配对指数，例如：“70%”；单星座配对情况下，为与之契合度最高的星座，以“No.1”加空格开头，例如：“No.1 双子男”
info string 必选 配对指数说明。双星座配对情况下，固定为“星座配对指数”；单星座配对情况下，为配对指数数据，例如：“配对指数：100%”
description string 必选 配对指数详细说明，具体描述，大于 30 字，三行截断

举例：从开发者服务器返回的 JSON (加密前)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "status": 0,
  "msg": "",
  "data": {
    "tag_list": [
      {
        "text ": "天蝎男和双鱼女",
        "url": "/path/to/tag1"
      },
      {
        "text ": "天蝎女和双鱼男",
        "url": "/path/to/tag2"
      }
    ],
    "score": "50%",
    "info": "星座配对指数",
    "description": "恋爱建议：在两人最初相遇时，往往都有相见恨晚的感觉。天蝎男在爱情之中的霸者地位",
    "jump_url": "/path/to/page"
  }
}

审核常见问题

卡片内容与 intent 的不相关

开发者提交的数据可能存在卡片展现的内容不符合 intent 体现的用户需求问题。以双鱼座与狮子座的星座配对为例，可能的 intent 及对应卡片内容正确示例如下：

constell_a constell_b text1 text2
双鱼女 狮子男 双鱼女和狮子男 双鱼男和狮子女
双鱼男 狮子女 双鱼男和狮子女 双鱼女和狮子男
双鱼女 狮子 双鱼女和狮子男 双鱼男和狮子女
双鱼男 狮子 双鱼男和狮子女 双鱼女和狮子男
双鱼 狮子女 双鱼男和狮子女 双鱼女和狮子男
双鱼 狮子男 双鱼女和狮子男 双鱼男和狮子女
双鱼 狮子 双鱼男和狮子女 双鱼女和狮子男
狮子女 双鱼男 狮子女和双鱼男 狮子男和双鱼女
狮子男 双鱼女 狮子男和双鱼女 狮子女和双鱼男
狮子女 双鱼 狮子女和双鱼男 狮子男和双鱼女
狮子男 双鱼 狮子男和双鱼女 狮子女和双鱼男
狮子 双鱼女 狮子男和双鱼女 狮子女和双鱼男
狮子 双鱼男 狮子女和双鱼男 狮子男和双鱼女
狮子 双鱼 狮子男和双鱼女 狮子女和双鱼男

卡片内容表述不客观

卡片中文字部分对两个星座的配对情况表述应客观，切勿提前设定搜索行为主体。错误示例如下：

类目 intent 卡片内容 是否通过 说明
星座配对 {“constell_a”:”白羊男”,”constell_b”:”天秤女”} “白羊男跟您相比，他神经大条……” 不通过 表述不客观，提前设定搜索行为主体为“天秤女”
宠物选宠卡 星座运势
反 馈帮 助 回 到顶 部