书法生成器

用户在搜索“书法字典”“书法转换器”等需求时，搜索结果页会展现书法生成器卡片。用户可在结果页设置字体、要转换的文字，点击按钮跳转至资源方落地页查看书法转换结果。

示意图

intent 上传接口

当前资源 intent 意图参数

key	类型	含义	示例/说明
calligraphy_generator	string	服务类型	可选，提供的服务类型-书法生成器

通过平台上传 txt 文件

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

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

1	{"calligraphy_generator":""}

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

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

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

{
  "type": "sp_ala",
  "srcid": "48064",
  "surface": "mobile",
  "intent": {
    "calligraphy_generator": ""
  }
}

从 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”
submit_url	string	必选	“生成毛笔字”按钮的跳转路径，跳转至生成的书法图片结果页。以“/page/of/target?param1={{val1}}&param2={{val2}}”形式上传，param1、param2 分别对应落地页获取用户选择的字体以及输入的待转换文字的 key，可根据需要改写为具体的名称，{{val1}}、{{val2}} 是固定字符，会替换为用户输入的具体数值，请不要修改
options	array	必选	字体选项列表
options.text	string	必选	字体下拉框的选项文案，字体的类型，如：“楷体”、“隶书”等，最短 1 个字符
options.value	string	必选	字体下拉框各选项对应的选项值，用于表单按钮提交路径中 param1 值的获取，最短 1 个字符
statement	string	必选	底部说明文案，对该生成器提供的功能的描述，最长 24 个字符

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

{
  "status": 0,
  "msg": "",
  "data": {
    "jump_url": "/page/of/target?id=1",
    "submit_url": "/page/of/target?param1={{val1}}&param2={{val2}}",
    "options": [
      { "text": "楷书", "value": "kaishu" },
      { "text": "草书", "value": "caoshu" },
      { "text": "行书", "value": "xingshu" },
      { "text": "隶书", "value": "lishu" },
      { "text": "篆书", "value": "zhuanshu" },
      { "text": "魏碑", "value": "weibei" }
    ],
    "statement": "提供书法字体在线转换，助您设计出好看的艺术字体。"
  }
}

反馈建议

书评开学放假安排