codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/20./350/277/236/346/216/245/345/231/250/351/233/206/346/210/220/40./350/277/236/346/216/245/345/231/250/346/261/207/346/200/273/981./344/274/201/345/276/256OA/345/256/241/346/211/271/350/277/236/346/216/245/345/231/250.md

@@ -0,0 +1,46 @@
+# 企微OA审批连接器
+
+## 功能概述
+
+企微OA审批连接器用于调用企业微信接口，实现获取审批模板详情、获取审批详情信息、发起审批申请、修改员工假期余额、查询审批单当前状态等操作。
+
+企业微信OA审批相关API参考文档和调试工具： [企业微信开发者中心 - 审批 - 概述](https://developer.work.weixin.qq.com/document/path/91854)
+
+## 功能介绍
+
+详细的接口使用说明与输入输出参数请参考对应的接口文档。
+
+| 所属分组 | 接口名                  | 功能介绍                                                       | 官网文档链接                                                     |
+| :--- | :------------------- | :--------------------------------------------------------- | :--------------------------------------------------------- |
+| 鉴权   | getAccessToken       | 获取access_token以调用企业微信API接 口                               | <https://developer.work.weixin.qq.com/document/path/91039> |
+| 审批操作 | gettemplatedetail    | 通过本接口获取指定模板的详情信息                                           | <https://developer.work.weixin.qq.com/document/path/91982> |
+| 审批操作 | applyevent           | 通过本接口使指定用户发起审批申请                                           | <https://developer.work.weixin.qq.com/document/path/91853> |
+| 审批操作 | getapprovalinfo      | 通过本接口，获取指定时间段内所有审批单的单号；可通过备选项设置筛选条件                        | <https://developer.work.weixin.qq.com/document/path/91816> |
+| 审批操作 | getapprovaldetail    | 通过本接口，获取指定审批单号的审批详情信息                                      | <https://developer.work.weixin.qq.com/document/path/91983> |
+| 审批操作 | getapprovaldata      | 通过本接口，获取一段时间内所有的审批记录数据                                     | <https://developer.work.weixin.qq.com/document/path/91530> |
+| 审批操作 | getcorpconf          | 通过本接口可以获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。 | <https://developer.work.weixin.qq.com/document/path/93375> |
+| 审批操作 | getuservacationquota | 通过本接口可获取应用可见范围内各个员工的假期余额数据。                                | <https://developer.work.weixin.qq.com/document/path/93376> |
+| 审批操作 | setoneuserquota      | 通过本接口可以修改可见范围内员工的 “假期余额”。                                  | <https://developer.work.weixin.qq.com/document/path/93377> |
+| 审批操作 | getopenapprovaldata  | 查询自建应用审批单当前状态                                              | <https://developer.work.weixin.qq.com/document/path/90269> |
+| 审批操作 | create_template     | 可以调用此接口创建审批模板。创建新模板后，管理后台及审批应用内将生成对应模板，并生效默认流程和规则配置。       | <https://developer.work.weixin.qq.com/document/path/97437> |
+| 审批操作 | update_template     | 可调用本接口更新审批模板。更新模板后，管理后台及审批应用内将更新原模板的内容，已配置的审批流程和规则不变。      | <https://developer.work.weixin.qq.com/document/path/97438> |
+
+
+## 使用说明
+
+1. 登录企业微信平台，获取corpid与corsecret参数。
+
+2. 在应用中导入连接器。
+
+3. 使用corpid与corsecret创建连接器实例。
+
+4. 在服务端逻辑中调用连接器。
+
+<img src="../assets/qiweioashenpilianjieqi_0605_1.png" style="border: 1px solid #ccc;max-width:700px;" />
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">老王</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年06月05日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/20./350/277/236/346/216/245/345/231/250/351/233/206/346/210/220/40./350/277/236/346/216/245/345/231/250/346/261/207/346/200/273/982./351/222/211/351/222/211OA/345/256/241/346/211/271/350/277/236/346/216/245/345/231/250.md

@@ -0,0 +1,52 @@
+# 钉钉OA审批连接器
+
+## 功能概述
+
+钉钉OA审批连接器用于调用钉钉开放平台接口进行OA审批，实现获取审批表单、创建/更新审批模板、同意/拒绝审批任务、下载审批附件等功能。
+
+钉钉OA审批相关API参考文档和调试工具：[钉钉开放平台 - OA审批 - 概述](https://open.dingtalk.com/document/orgapp/workflow-overview)
+
+## 功能介绍
+
+详细的接口使用说明与输入输出参数请参考对应的接口文档。
+
+| 所属分组      | 接口名                             | 功能介绍                         | 官方文档链接                                                                                             |
+| :-------- | :------------------------------ |:-----------------------------| :------------------------------------------------------------------------------------------------- |
+| 鉴权        | getAccessToken                  | 获取access_token以调用钉钉开放平台API接口 | <https://open.dingtalk.com/document/orgapp/obtain-the-access_token-of-an-internal-app>             |
+| 审批表单      | obtainFormSchema                | 通过本接口获取审批表单schema            | <https://open.dingtalk.com/document/orgapp/obtain-the-form-schema>                                 |
+| 审批表单      | createApprovalFormTemplate      | 通过本接⼝创建审批模板                  | <https://open.dingtalk.com/document/orgapp/create-an-approval-form-template>                       |
+| 审批表单      | updateApprovalFormTemplate      | 通过本接⼝更新审批模板                  | <https://open.dingtalk.com/document/orgapp/create-an-approval-form-template>                       |
+| 审批表单      | getAllFormsWithinEnterprise     | 通过本接口获取当前企业所有可管理的表单          | <https://open.dingtalk.com/document/orgapp/get-all-manageable-forms-for-the-current-enterprise>    |
+| 审批表单      | obtainApprovalFormInformation   | 通过本接口获取审批单流程节点信息             | <https://open.dingtalk.com/document/orgapp/approval-process-prediction>                            |
+| 审批表单      | getAllFormsWithinEnterprise     | 调用本接口，获取用户在当前企业所有可管理的审批表单    | <https://open.dingtalk.com/document/orgapp/get-all-manageable-forms-for-the-current-enterprise>    |
+| 审批实例      | launchApprovallnstance          | 通过本接口发起审批实例                  | <https://open.dingtalk.com/document/orgapp/create-an-approval-instance>                            |
+| 审批实例      | obtainApprovallnstance          | 通过本接口获取单个审批实例详情              | <https://open.dingtalk.com/document/orgapp/obtains-the-details-of-a-single-approval-instance-pop>  |
+| 审批实例      | undoApprovallnstance            | 通过本接口撤销审批实例                  | <https://open.dingtalk.com/document/orgapp/revoke-an-approval-instance>                            |
+| 审批实例      | addApprovalComments             | 添加审批评论                       | <https://open.dingtalk.com/document/orgapp/add-an-approval-comment-pop>                            |
+| 审批实例      | obtainApprovallnstancelDList    | 调用此接口获取审批实例ID列表              | <https://open.dingtalk.com/document/orgapp/obtain-an-approval-list-of-instance-ids>                |
+| 审批任务      | agreeRefuseOAinstance           | 调用本接口同意或拒绝审批任务               | <https://open.dingtalk.com/document/orgapp/approve-or-reject-the-approval-task>                    |
+| 审批任务      | redirectOAinstance              | 转交OA审批任务                     | <https://open.dingtalk.com/document/orgapp/transfer-the-oa-approval-task>                          |
+| 审批任务      | getOAnumbe                      | 获取用户待审批数量                    | <https://open.dingtalk.com/document/orgapp/queries-the-number-of-requests-to-be-approved-by-users> |
+| 审批钉盘空间&附件 | getApprovalSpacelnfc            | 获取审批钉盘空间信息                   | <https://open.dingtalk.com/document/orgapp/obtains-the-information-about-approval-nail-disk>       |
+| 审批钉盘空间&附件 | authorizedPreviewApprovalAnnex  | 授权预览审批附件                     | <https://open.dingtalk.com/document/orgapp/preview-authorization-attachment-pop>                   |
+| 审批钉盘空间&附件 | authorizedDownloadApprovalFiles | 授权下载审批钉盘文件                   | <https://open.dingtalk.com/document/orgapp/download-the-approval-nail-file>                        |
+| 审批钉盘空间&附件 | downloadApprovalAttachment      | 下载审批附件                   | <https://open.dingtalk.com/document/orgapp/download-an-approval-attachment>                        |
+
+## 使用说明
+
+1. 登录钉钉开放平台，获取appKey、appSecret、userId、corpId、API token。
+
+2. 在应用中导入连接器。
+
+3. 使用appKey、appSecret、userId创建连接器实例。
+
+4. 在服务端逻辑中调用连接器
+
+<img src="../assets/dingdingoashenpilianjieqi_0605_1.png" style="border: 1px solid #ccc;max-width:700px;" />
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">老王</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年06月05日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/30./345/272/224/347/224/250API/351/233/206/346/210/220/10./345/272/224/347/224/250API/347/256/241/347/220/206/345/212/237/350/203/275.md

@@ -0,0 +1,386 @@
+# 应用API管理功能
+
+## 功能概述
+
+Codewave平台支持应用API管理功能，可管理CodeWave应用导出的API和第三方API。
+
+- **CodeWave应用API**：
+
+    由CodeWave应用导出接口生成，不支持编辑和删除。即每个CodeWave应用都会在应用API管理下有一个对应的API分组，用于查看该应用中开放的接口。当删除CodeWave应用后，对应的API分组也随之删除。
+
+- **第三方API**：
+
+    用于管理外部接口，定义的接口可以在CodeWave应用中调用。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_1.png" class="imgStyle" style="width:800px;" />
+
+当需要在CodeWave应用中调用外部接口时，只需进行以下几步操作：
+1. 创建API分组
+2. 在API分组中创建API
+3. 添加API的请求信息（query、header、body）
+4. 添加API的响应信息（header、body）
+5. 调试API（可选）
+6. 在CodeWave应用中调用API
+
+具体的使用案例可以参考：[第三方API导入案例](../30.应用API集成/20.第三方API导入案例.md)，按照案例文档进行操作，调用查询手机号归属地的接口。
+
+使用API功能遇到问题时可参考[API使用常见问题](../30.应用API集成/25.API使用常见问题.md)
+
+## 功能入口
+
+在菜单栏单击**集成中心 > 应用API管理**，即可进API管理界面。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_2.png" class="imgStyle" style="" />
+
+**所需权限**
+
+只有当登录平台的用户有相关权限时，才可以看到“应用API管理”的入口，权限所需的资源为`/dashboard/apigateway`，如果看不到入口，请联系平台管理员开通对应的权限，如图所示。
+
+<img src="../assets/yingyongapiguanligongneng_0506_3.png" style="border: 1px solid #ccc;max-width: 80%;" />
+
+只有当用户拥有“app/create”（应用创建）权限时，才能在API管理页中看到“创建API分组”按钮。
+
+<img src="../assets/yingyongapiguanligongneng_202504301818_1.png" style="border: 1px solid #ccc;max-width: 80%;" />
+
+## 功能介绍
+
+### 创建API分组
+
+在应用API管理页面点击“创建API分组”按钮，在弹窗中输入API信息后进行创建。
+
+- 接口来源：可选择第三方应用或第三方注册中心，微服务接口需要选择第三方注册中心，常规接口选择第三方应用即可。
+- 协议：支持HTTP和HTTPS协议。
+- 分组名称：该API分组的名称，支持字母、中文、数字、下划线、中划线或.组成。
+- 分组标识：该API分组的唯一标识，支持字母、数字和下划线，需以字母开头。
+- 调用域名：API的根地址，填前置URL即可，例如`http://a.com`，具体每个接口的URL路径需要进入到API分组中单独设置。需要为不同环境设置不同的接口根地址时可勾选“区分环境”。
+- 区分开发生产环境：该配置仅当接口来源为第三方应用时可见，勾选后可分别配置生产环境和开发环境下不同的调用域名。
+- 调用微服务名：该配置仅当接口来源为第三方注册中心时可见，代表要调用的微服务名。
+- 分组描述：该API分组的备注信息。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_3.png" class="imgStyle" style="" />
+
+### API分组的授权管理
+
+管理员账号和API分组的创建者可以将API分组授权给其他开发者，如图所示点击后进入授权页面。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_4.png" class="imgStyle" style="" />
+
+API分组的权限控制默认为关闭状态，在授权页面中需要先开启权限控制才能进行授权，开启后可添加授权用户，支持为每个用户单独设置权限：
+
+- 调用：默认勾选不可取消，有该权限的用户可在CodeWave应用中调用该接口。
+- 修改：有该权限的用户可修改API分组。
+- 删除：有该权限的用户可删除API分组。
+- 授权：有该权限的用户可对该API分组进行授权管理。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_5.png" class="imgStyle" style="" />
+
+### 修改或删除API分组
+
+在API分组列表中可进行API分组的删除和修改，也可进入特定的API分组后再进行修改或删除，分组名称和分组标识不可修改。
+
+注意：CodeWave应用产生的API分组不支持修改和删除，其生命周期与CodeWave应用一致。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_6.png" class="imgStyle" style="" />
+
+### 导入/导出swagger接口文档
+
+在分组详情页面中可选择导入或导出swagger接口文档。仅支持手动创建的API分组使用导入接口功能，CodeWave应用自动生成的API分组不支持导入接口。
+
+- 自动导入接口：将swagger接口文档中的API导入到该API分组下。目前导入接口Swagger2.x仅支持json格式，3.0和3.1支持json、yaml格式。平台3.9版本开始支持导入swagger的接口名称为中文。
+- 导出接口：导出该API分组为swagger接口文件。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_7.png" class="imgStyle" style="" />
+
+### API管理
+
+API管理选项卡中包含数据接口和数据模型两个模块，数据接口模块用于管理具体的接口，数据模型用于管理接口中用到的结构体。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_8.png" class="imgStyle" style="" />
+
+#### 创建API
+
+可选择两种方式创建API：
+
+- **常规方式创建**：
+
+    点击【创建API】按钮，在弹窗中输入接口信息，
+
+    - 接口名称：支持中文、大小写字母、下划线、数字。
+    - 接口标识：支持英文字母或数字, 必须以英文字母开头, 且不超过32个字符。
+    - 请求标识：HTTP请求方法。
+    - 请求路径：“请求路径”为除请求域名以外的路径。例如，需要调用的接口地址为`http://a.com/api/getUserInfo`，，该API分组的请求域名为`http://a.com`，则请求路径只需要输入`/api/getUserInfo`。
+    - 描述信息：该接口的备注信息。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_9.png" class="imgStyle" style="" />
+
+    创建API后，需要进入该API的详情页，修改请求信息和响应信息。请求信息或响应信息中包含复杂数据类型时，需要先创建对应的数据模型。
+
+    **请求信息参数说明**
+
+    - Request URL：接口的请求路径。
+    - Request Path：接口的路径参数，在填写接口请求路径时可使用英文大括号代表动态的请求路径。例如，某RESTful风格接口的请求路径为：`/api/get/{name}/{phone}`，则name和phone两个path参数可以在调用接口时动态传参。
+
+        <details>
+        <summary title="点击查看Request Path使用示例" style="">
+             点击查看Request Path使用示例
+        </summary>
+
+        1. 创建接口时在请求路径中使用英文大括号{xxx}代表动态路径，可参考下图。
+        <img src="../assets/yingyongAPIguanligongneng_202407032040_10.png" class="imgStyle" style="width:450px;" />
+
+        2. 在请求信息的Request Path中可查看添加的动态路径，可修改数据类型。
+        <img src="../assets/yingyongAPIguanligongneng_202407032040_11.png" class="imgStyle" style="" />
+
+        3. 调用该接口时，需要传入path参数。
+        <img src="../assets/yingyongAPIguanligongneng_202407032040_12.png" class="imgStyle" style="width:700px;" />
+        
+        </details>
+    - Query String：查询参数。
+    - Request Header：请求头。
+    - Request Body：请求体。请求体的JSON内容中有几个字段就需要添加几个Request Body字段，如果JSON中存在复杂嵌套，则需要先[创建数据模型](#创建数据模型)。如果Body不是JSON格式，请参考下文：[请求/响应的Body不为JSON时如何设置](#请求-响应的body不为json时如何设置)。
+
+    **响应信息参数说明**
+
+    - Response Header：响应头。
+    - Request Body：响应体。响应体的JSON内容中有几个字段就需要添加几个Response Body字段，如果JSON中存在复杂嵌套，则需要先[创建数据模型](#创建数据模型)。如果Body不是JSON格式，请参考下文：[请求/响应的Body不为JSON时如何设置](#请求-响应的body不为json时如何设置)。
+
+    **示例：为API添加一个query参数。**
+
+    创建API后进入到详情页，选择【请求信息】，点击修改进入编辑模式。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_13.png" class="imgStyle" style="" />
+
+    添加一个Query后点击保存即可。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_14.png" class="imgStyle" style="" />
+
+- **快捷创建API**
+
+    快捷创建API功能可根据录入的请求body、响应body自动生成对应的数据模型，简化了创建数据模型的步骤。点击调试按钮可直接进行API请求测试，调试响应结果可快捷填充到响应body中。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_15.png" class="imgStyle" style="" />
+
+#### 创建数据模型
+
+数据模型是指接口请求体或响应体中使用到的数据结构，当API的请求/响应内容中有复杂类型时需要先创建对应的数据结构。
+
+提供两种创建数据模型的方式，手动创建或根据JSON生成数据模型：
+
+- **手动创建数据模型**
+
+    点击【创建数据模型】按钮，输入模型名称后点击创建。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_16.png" class="imgStyle" style="" />
+
+    进入该模型详情页面，添加属性，属性可使用的数据类型除平台常见类型以外，还可以使用该API分组中的其他数据模型，进行数据结构的嵌套。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_17.png" class="imgStyle" style="" />
+
+    注意，字段类型支持设置为联合类型，适用于同一字段可能存在不同类型的场景。例如`info`字段可能既是String类型也是Object类型。
+
+    ![](../assets/yingyongAPIguanligongneng_202511251110_1.png)
+
+- **JSON生成数据模型**
+
+    点击【JSON生成数据模型】，可根据输入的JSON自动生成相应的数据模型，需要手动修改时可进入该模型详情页进行编辑。
+
+    <img src="../assets/yingyongapiguanligongneng_0506_20.png" style="border: 1px solid #ccc;" />
+
+在应用中引入了API后，可以在**数据IDE > 接口**下查看API分组下的数据模型。
+
+变量的数据类型可以使用这从接口中引入的类型，或者在逻辑中使用“新建”组件并选择数据模型。
+
+<img src="../assets/yingyongapiguanligongneng_202502141117_1.png" style="" />
+
+<img src="../assets/yingyongapiguanligongneng_202502141117_2.png" style="" />
+
+### API的使用
+
+创建好的API可在逻辑中使用，在右侧组件列表中选择【调用接口】拖拽到画布中即可，调用普通接口时【接口来源】选项选择应用API管理模块即可，调用微服务接口时需要选择微服务连接器名。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_18.png" class="imgStyle" style="" />
+
+搜索API分组：选择了接口来源后再选择需要调用的接口，可在搜索框中输入API分组名称或标识进行搜索。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_19.png" class="imgStyle" style="width:700px;" />
+
+搜索API：当分组下的API数量比较多时，可点击API分组右侧的搜索框，输入API名称进行搜索。
+
+<img src="../assets/yingyongAPIguanligongneng_202407032040_20.png" class="imgStyle" style="width:700px;" />
+
+### API调试
+
+为方便开发者测试API，平台提供API调试能力，可从应用API管理或应用IDE中选择接口进行调试。
+
+- **方式一：在API详情页进行调试**
+
+    在API详情界面，可点击【调试】按钮，进行接口请求测试。调试前注意补充接口所需的Body或Query、Herder参数。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_21.png" class="imgStyle" style="" />
+
+- **方式二：在应用IDE内进行调试**
+
+    使用调用接口组件时，可点击如图所示按钮，在IDE内查看该接口的详细信息并进行接口调试。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_22.png" class="imgStyle" style="" />
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_23.png" class="imgStyle" style="" />
+
+### 在CodeWave应用中开放接口
+
+CodeWave应用的服务端逻辑支持开放为接口，具体操作步骤如下：
+
+1.  右键单击对应的服务端逻辑，在弹出框中单击开放为接口。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_24.png" class="imgStyle" style="width:450px;" />
+
+2.  在弹窗中编辑接口基本信息，完成编辑后单击下一步按钮。
+
+    - 接口名称：接口的标识，决定了接口的请求路径。
+    - 请求方法：
+
+        - GET ：向指定的URL请求资源，可携带参数（明文）。
+        - POST ：向指定的URL提交资源，表单数据提交，数据进行封装（比Get方法安全）。
+        - PUT ：与POST类似，通常用于对资源数据的更新修改。
+        - DELETE ：删除指定的资源。
+    - 请求路径：不可手动修改，该接口的请求路径为`应用地址/rest/接口名称`
+    - 关联逻辑：不可手动修改，表示该接口对应的服务端逻辑。
+    - 接口上报：开放的接口需要上报到何处，默认为平台的应用API管理模块，引入微服务连接器后可选择上报到微服务注册中心，使用方式可参考[应用API对接微服务架构](../30.应用API集成/28.应用API对接微服务架构.md)
+    - 描述信息：接口的备注信息。
+
+      <img src="../assets/yingyongAPIguanligongneng_202407032040_25.png" class="imgStyle" style="width:450px;" />
+
+3.  可选择配置该接口的鉴权方式，文档请参考接口鉴权简介。默认不设置鉴权。
+
+    <img src="../assets/yingyongapiguanligongneng_0506_7.png" style="border: 1px solid #ccc;width: 700px;" />
+
+4.  逻辑的输入参数与接口参数相对应，可为每个参数指定请求类型（query、body、header），参数的默认值由逻辑输入参数的默认值决定。
+
+    点击“导出”即可将该逻辑开放为接口，在应用发布后即可调用该接口。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_26.png" class="imgStyle" style="width: 700px;" />
+
+    应用发布后，进入到该CodeWave应用对应的API分组中，可以看到该应用开放的接口。
+
+    <img src="../assets/yingyongAPIguanligongneng_202407032040_27.png" class="imgStyle" style="" />
+
+需要注意的是，只能选择一个逻辑输入参数作为body参数，且数据类型为非基础类型的参数只能作为body，不能作为query、header。
+
+希望将多个数据作为Body参数时，可自行创建数据结构，在数据结构中创建多个属性，并将该数据结构作为逻辑的输入参数类型。
+
+以下图为例，逻辑的输入参数有Book实体和Student实体两个输入参数，在开放为接口时会报错，提示只能有一个body。
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_1.png" class="imgStyle" style="" />
+
+这种情况下，可以创建一个数据结构，数据结构中分别使用两个属性来承载两个实体。
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_2.png" class="imgStyle" style="" />
+
+逻辑的输入参数类型使用该数据结构，开放为接口时将该参数作为body。
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_3.png" class="imgStyle" style="" />
+
+开放为接口并发布应用后，可以在API详情页中看到RequestBody参数中有多个参数。
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_4.png" class="imgStyle" style="" />
+
+调用该接口时，body的入参示例如下：
+
+```json
+{
+    "book": {
+        "id": 123,
+        "createdTime": "2024-08-01T00:00:11.000Z",
+        "updatedTime": null,
+        "createdBy": null,
+        "updatedBy": null,
+        "name": "三国演义",
+        "writer": "罗贯中",
+        "price": 22.8
+    },
+    "student": {
+        "id": 66666,
+        "createdTime": "2024-08-01T00:00:11.000Z",
+        "updatedTime": null,
+        "createdBy": null,
+        "updatedBy": null,
+        "name": "张三",
+        "age": "18"
+    }
+}
+```
+
+### SSL证书验证
+
+API的协议为https时，可以在分组详情界面中配置是否进行SSL证书验证，新建的API分组与历史API分组默认为开启状态。修改该配置后，调用了该接口的应用需要重新发布才会生效。
+
+> 通常调用https接口都需要进行SSL证书验证，如果接口使用了自签名证书或过期的证书，调用时出现了SSL验证错误，可以关闭这个开关从而实现正常调用。
+
+<img src="../assets/yingyongapiguanligongneng_202410081041_1.png" class="imgStyle" style="" />
+
+### 调用异常时自动重试
+在调用第三方接口时可能因为网络波动、调用超时等原因导致调用失败，可以在应用中为外部接口设置异常时重试，以提高接口调用的稳定性。异常重试机制仅在服务端逻辑调用时生效。
+
+需要为外部接口设置异常重试时，如图所示操作，切换到**逻辑IDE>接口>外部接口**，选择需要设置的接口，在右侧属性面板中设置重试次数和重试间隔。
+
+- 重试次数：访问失败后重试的最大次数，超过将不重试。
+- 重试间隔：单次访问失败到下次重试开始之间的间隔时间。
+
+<img src="../assets/yingyongapiguanligongneng_202412021709_1.png" class="imgStyle" style="" />
+
+设置重试次数时需要考虑整体的接口超时时间限制，(重试次数×重试间隔秒数)应小于超时时间，接口超时时间的设置方式如下图所示，位于**应用配置>系统参数配置**下。
+
+<img src="../assets/yingyongapiguanligongneng_202412021709_2.png" class="imgStyle" style="" />
+
+## 补充说明
+
+### 请求/响应的Body不为JSON时如何设置
+
+配置第三方接口的请求信息时，如果接口的请求体(RequestBody)或响应体（ResponseBody）不是JSON结构，这种情况下需要在body中添加名称为_blank的字段。
+
+示例：
+
+现有一个接口，Body入参需要为一个整数，接口响应结果为该整数的平方。
+
+- 入参body示例：8
+- 返回值body示例：64
+
+该接口的特点是，出入参body中的内容并不是键值对的结构，只有一个值。
+
+对于这种接口，需要在RequestBody（以及ResponseBody）中添加一个名称为_blank的字段，平台在识别到_blank参数时不会再多包一层结构体。
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_5.png" class="imgStyle" style="width:800px;" />
+
+这种场景下如果不使用\_blank作为字段名，例如像下图一样命名为number，则调用接口时实际的Body内容是JSON，而不是预期的一个数字。
+
+```json
+{
+    "nunber": 8
+}
+```
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_6.png" class="imgStyle" style="width:800px;" />
+
+***
+
+### 请求体Body和返回值Body的数据类型
+
+对于应用中引入的每一个接口，其请求Body和返回结果都有对应的数据类型。
+
+如图所示，在应用中调用了某接口后，可以在数据IDE的目录树中看到该接口的Body和返回值对应的数据类型。
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_7.png" class="imgStyle" style="" />
+
+- Body数据类型的命名规则为`接口标识+Body`，例如接口标识为`updateBook`，则该接口body的数据类型为`updateBookBody`
+- 接口返回值类型的命名规则为`ApiResultOf+接口标识`，例如接口标识为`updateBook`，则该接口返回值的数据类型为`ApiResultOfUpdateBook`。
+
+调用接口时，可以通过搜索接口标识来查找所需的数据类型。
+
+<img src="../assets/yingyongapiguanligongneng_202408261802_8.png" class="imgStyle" style="" />
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">老王</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2025年11月24日</span>
+</div>