连接类型向导化实现WebAPI登记和鉴权

1 开发环境准备

• 苍穹版本：2024-01-26 V6.0.6(BIZ) 

• 学习资料：https://zhangtianyue.notion.site/API-83fe7dbd384044858674871b09e25895#2302cde44dfc452e84e5ba3d2f902a11

• 说明：API文档分为两部分，获取系统token和获取系统人员，这个API我是在mock服务器上搭建的，数据无意义只是模拟调用供演示使用。

 2 开发流程

首先使用postman开发登记，根据获取token部分，我们可以根据文档在postman中配置如下调用请求,取出cURL命令。

curl --location 'https://mockapi.kingdee.com/api/v1/autn/token' \
--header 'Content-Type: application/json' \
--data '{
  "username": "admin",
  "password": "password123"
}
'

提前看下调用的API是如何使用token认证，并且如何获取失效时间的，按照文档中的获取人员信息和组织信息，使用的是Bearer 认证，token失效时间在expires_in中，单位是秒，这步很重要，后面会讲为什么要提前看。

我们讲cURL命令复制，打开集成管理-连接管理-连接类型-向导新增按钮，创建WebAPI按钮可以勾选，本次演示我为了方便后续使用者，就独立出来。

点击下一步粘贴刚才生成的cURL命令，点击转换

此时我们要根据URL参数，请求头，请求体的实际内容做好分录配置，比如有的获取token有url参数，那就要切换到对应的页签，样例中我们切换到请求体，然后调整参数。

这里介绍下几个复选框的含义，在连接配置中配置，一遍表示可变参数，比如登录的人员不同，uat和生产的账户不同，参数作为默认值，参数就会默认带入连接配置中，按需修改即可，必填则表示在连接配置中参数必须配置，参数值作为密码，表示数据在前端不可见展示，用户配置连接时需要重新输入。

样例中，请求体的两个参数则会按照以下语义配置，请求头则不配置分录，直接在脚本中使用默认值。实际的API大家按需调整请求头和URL参数。

重点，由于后续的接口API（获取人员信息和组织信息），token的使用并不是直接用的获取token的默认值，而是使用Bearer认证，并且刷新时间在token的data返回值中，因此我们要调整脚本。

打开脚本模式，修改脚本的刷新时间（一般建议调整到token失效前的300*1000毫秒左右）和组装新的token，由于样例中返回的access_token需要Bearer认证，因此手动组装一个新的$token来承接，如果实际的调用API不需要对token额外处理时可以直接使用请求返回的内容。

填写好编码名称，点击测试后可以查看请求token的结构，然后进入下一步，响应体的内容在后续WebAPI调用中会使用。

刷新脚本就是重新获取token的脚本，绝大部分场景都是一致勾选开关即可，如果有不一致的场景，则重复登录脚本的过程。

保存后下