星座运势

用户在搜索星座运势时,搜索会展现“星座运势“卡片,提供某星座运势、财运指数等信息,满足用户的需求。

示意图

星座运势 - 图1

intent 上传接口

当前资源 intent 意图参数

key类型含义示例/说明
constellationstring星座名“摩羯座”
timespanstring时间周期“今日”/“明日”/“本周”/“本月”/“2019 年” 等,可为空

通过平台上传 txt 文件

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

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

  1. {"constellation":"天蝎座","timespan":""}
    {"constellation":"天秤座","timespan":"今日"}
    {"constellation":"白羊座","timespan":"本周"}
    {"constellation":"水瓶座","timespan":"2019年"}

星座运势 - 图2

通过开放 API 上传

未开放

Webhook API

发送给 webhook 的请求

公共字段

key类型含义示例/说明
typestring请求类型(大部分开发者可不关心)在小程序阿拉丁下永远为 “sp_ala”
surfacestring搜索场景(大部分开发者可不关心)mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索
srcidstring资源编号每个资源分类不同
intentobject搜索意图参数JSON 对象,每个资源分类不同

当前资源 srcid 资源编号

key类型含义设定
srcidstring资源编号5527

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

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

  1. {
    "type": "sp_ala",
    "srcid": "5527",
    "surface": "mobile",
    "intent": {
    "constellation": "天秤座",
    "timespan": ""
    }
    }

从 webhook 返回的结果

外层通用数据字段

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

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

key类型要求说明
jump_urlstring必选卡片标题的跳转链接,跳转到展示星座运势详细信息的页面
tag_listarray必选tag 区域,tag 数据必须 3 条
tag_list.textstring必选tag 文案,例如”今日运势”/“明日运势”/“本周运势”,可根据意图 intent 调整 tag 顺序
tag_list.urlstring必选tag 的跳转链接
fortune_answerstring必选运势概述
fortune_definitionstring必选运势定义
descriptionstring必选运势描述,具体描述,大于 30 字
composite_scorenumber必选综合指数得分
composite_score_totalint必选综合指数总分,总分为 5 分
love_scorenumber必选爱情指数得分
love_score_totalint必选爱情指数总分,总分为 5 分
money_scorenumber必选财运指数得分
money_score_totalint必选财运指数总分,总分为 5 分
cause_scorenumber必选事业指数得分
cause_score_totalint必选事业指数总分,总分为 5 分

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

  1. {
    "status": 0,
    "msg": "",
    "data": {
    "tag_list": [
    {
    "text ": "今日运势",
    "url": "/path/to/tag1"
    },
    {
    "text ": "明日运势",
    "url": "/path/to/tag2"
    },
    {
    "text ": "本周运势",
    "url": "/path/to/tag3"
    }
    ],
    "fortune_answer": "运势极佳",
    "fortune_definition": "摩羯座今日运势",
    "description": "摩羯座今日运势极佳,因为上升星座xxxx",
    "composite_score": 4,
    "composite_score_total": 5,
    "love_score": 4,
    "love_score_total": 5,
    "money_score": 3,
    "money_score_total": 5,
    "cause_score": 4.5,
    "cause_score_total": 5,
    "jump_url": "/path/to/page"
    }
    }

审核常见问题

卡片内容与 intent 不相关

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

constellationtimespantext1text2text3
狮子座今日狮子座今日运势
狮子座明日狮子座明日运势
狮子座本周狮子座本周运势
狮子座本月狮子座本月运势
狮子座今年狮子座今年运势

卡片内容表述不客观

卡片中文字部分对星座运势的表述应客观,避免添加过多修饰以至不符合用户搜索场景的情况。典型的错误示例如下:

类目intent卡片内容是否通过说明
星座运势{“constellation”:”水瓶座”,”timespan”:”2019 年”}“进入新的 2019 年,水瓶座将迎来不同的……”不通过该陈述仅适用于 2019 年初