Webhook 接入方式会将语义理解服务生成的数据传递到您的 Web 服务中并从中获取结果。该 Web 服务需要开发者自己搭建,并且需要遵从平台预先定义好的输入输出。
1. 认证文件校验
目前开放平台将对开发者填写的 Webhook 服务地址做真实性校验(检测服务地址的有效性和开发者对服务地址是否有权限)。
在配置 Webhook URL 前请先下载技能的认证文件,并将认证文件配置在服务器中供平台检测。
认证文件的配置方法为:如果您开发的是基于 Tomcat 等运行的普通 Web 项目,请将下载的认证文件放到要配置的服务地址所属服务器软件上。PS:服务器软件是指 Tomcat / Nginx / Jetty 等,而不是运行服务器所依赖的操作系统。文件存放路径为:服务器软件根目录/aligenie/认证文件。
如果您开发的是 Springboot Web 项目,最后是可执行 jar 包在服务器运行,Springboot 项目内置有 Tomcat 插件,所以认证文件放置在项目中即可,文件存放路径为:resources/static/aligenie/认证文件。
平台的检测方法为:
获取您配置的 Webhook URL,取出URL中域名和端口号(如果有),然后拼接上"aligenie/认证文件名.txt"访问这个路径,以返回的结果(认证文件的内容)作为依据,判断认证是否成功。
例如:下载到的