值机服务

当用户搜索『海航值机』、『网上值机』等存在值机需求 query；根据 query，卡片展现『值机服务』等卡片内容，并跳转到对应的相应的落地页。从而满足用户的需求。

示意图

intent 上传接口

当前资源 intent 意图参数

key	类型	含义	示例/说明
airline_company	string	航司名称	海航、海南航空

通过平台上传 txt 文件

资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上，由于请在上传的时候，上传一个空 intent，用于缺省航司时的泛需求召回。txt 文件的具体要求参见接入流程-上传 Intent 数据。

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

1	{"airline_company":"海航"}

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

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

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

{
  "type": "sp_ala",
  "srcid": "48048",
  "surface": "mobile",
  "intent": {
    "airline_company": "海航"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

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

key	类型	要求	说明
app_name	string	必选	资源方名称，最短 1 个字符
app_icon	string	必选	资源方图标，最短 1 个字符
jump_url	string	必选	落地页跳转链接
head_title	string	必选	头部：默认在线值机在线值机服务，最短 1 个字符
service_source	string	必选	资源方名称，最短 1 个字符
service_title	string	必选	服务标题：默认轻松值机选座，可根据 intent 变化跳转，最短 1 个字符，最长 200 个字符

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

{
  "status": 0,
  "msg": "",
  "data": {
    "app_name": "飞常准",
    "app_icon": "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1575354388780&di=e67fdd54942c86c5abae5d342c2188b8&imgtype=0&src=http%3A%2F%2Fwww.51yuansu.com%2Fpic%2Fcover%2F00%2F05%2F54%2F573d230acfef9_610timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1575354388780&di=e67fdd54942c86c5abae5d342c2188b8&imgtype=0&src=http%3A%2F%2Fwww.51yuansu.com%2Fpic%2Fcover%2F00%2F05%2F54%2F573d230acfef9_610timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1575354388780&di=e67fdd54942c86c5abae5d342c2188b8&imgtype=0&src=http%3A%2F%2Fwww.51yuansu.com%2Fpic%2Fcover%2F00%2F05%2F54%2F573d230acfef9_610.jpg",
    "jump_url": "http://m.baidu.com",
    "service_title": "在线值机服务",
    "service_source": "飞常准",
    "service_title": "轻松值机选座",
    "service_text": "提供国内航司航班值机服务",
    "service_isofficial": true
  }
}

开发者 intent 提交要求

intent 提交应该考虑一下三个问题：

1、提交 intent 和自己接口返回内容的匹配度：

intent	service_tile	jump_url	service_isofficiial
	网上值机	值机首页	有官方标
海航	海航值机服务	航司默认选择为『海航』	非航司授权服务无官方标

2、自己能否提供该 intent 对应的服务：比如资源方在没法提供海航的值机服务，则不应提交”海航””海南航空”这类 intent。
3、需要保证用户在小程序使用服务的全流程体验。

反馈建议

租车服务拍摄取景地