房贷计算器

房贷计算器

用户搜索房贷计算有关的关键词时，展现房贷计算器服务卡片，用户点击卡片可进入资源方的小程序，在小程序里完成房贷相关信息的输入和计算。

示意图

房贷计算器

intent 上传接口

当前资源 intent 意图参数

key	类型	含义	示例/说明
calculator	string	计算器类型	必选，能够提供的服务类型，如：”商业贷款”，”公积金贷款”等

通过平台上传 txt 文件

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

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

{"calculator": ""}

注意：为了能够召回泛需求，必须且仅需上传一个空的 intent

通过开放 API 上传

未开放

Webhook API

发送给 webhook 的请求

公共字段

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

当前资源 srcid 资源编号

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

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

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

{
  "type": "sp_ala",
  "srcid": "48022",
  "surface": "mobile",
  "intent": {
    "calculator": ""
  }
}

从 webhook 返回的结果

外层通用数据字段

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

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

key	类型	要求	说明
url	string	必选	服务区跳转链接
head_title	string	必选	头部标题文案，服务名称，如：”房贷计算器”，对于一种服务来讲，头部标题文案固定不变
source_text	string	必选	头部副标题文案，服务提供者名称，如：”康波财经”，对于一个服务提供者来讲，头部副标题文案固定不变
img_src	string	必选	头部图片链接，一般为服务提供者的 logo
service_title	string	必选	服务区标题，一般为资源方提供的主要服务名称；如：房贷计算
service_introduction	string	必选	服务区文案，关于主要服务的说明，可将提供服务类型的关键词进行罗列，如：:”商业贷款公积金贷款组合贷款按贷款金额计算按每月还款计算”

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

{
  "status": 0,
  "msg": "",
  "data": {
    "url": "http://m.baidu.com",
    "head_title": "房贷计算器",
    "source_text": "康波财经",
    "img_src": "https://cambrian-images.cdn.bcebos.com/c57f21498e7fe9e160d8829778dd0130_1599343100266931.jpeg@w_100,h_100",
    "service_title": "房贷计算",
    "service_introduction": "商业贷款｜公积金贷款｜组合贷款｜按贷款金额计算｜按每月还款计算"
  }
}