ExternalInstance (larksuite-oapi 2.8.5 API)

java.lang.Object
- com.lark.oapi.service.approval.v4.resource.ExternalInstance

public class ExternalInstance
extends Object

构造器概要

构造器
构造器和说明

ExternalInstance(Config config)

构造器
构造器和说明
`ExternalInstance(Config config)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`CheckExternalInstanceResp`	`check(CheckExternalInstanceReq req)` 校验三方审批实例，调用该接口校验三方审批实例数据，用于判断服务端数据是否为最新的。
`CheckExternalInstanceResp`	`check(CheckExternalInstanceReq req, RequestOptions reqOptions)` 校验三方审批实例，调用该接口校验三方审批实例数据，用于判断服务端数据是否为最新的。
`CreateExternalInstanceResp`	`create(CreateExternalInstanceReq req)` 同步三方审批实例，审批中心不负责审批的流转，审批的流转在三方系统。
`CreateExternalInstanceResp`	`create(CreateExternalInstanceReq req, RequestOptions reqOptions)` 同步三方审批实例，审批中心不负责审批的流转，审批的流转在三方系统。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - ExternalInstance
```
public ExternalInstance(Config config)
```
- 方法详细资料
  - check
```
public CheckExternalInstanceResp check(CheckExternalInstanceReq req,
                                       RequestOptions reqOptions)
                                throws Exception
```
    校验三方审批实例，调用该接口校验三方审批实例数据，用于判断服务端数据是否为最新的。请求时提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 ID。;;例如，设置定时任务每隔 5 分钟，将最近 5 分钟产生的实例使用该接口进行对比。如果数据在服务端不存在或者不是最新，则可以根据本接口返回的实例 ID、任务 ID，前往[同步三方审批实例](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/create)。
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=check&project=approval&resource=external_instance&version=v4 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/approvalv4/CheckExternalInstanceSample.java ;
    
    抛出:
    
    Exception
  - check
```
public CheckExternalInstanceResp check(CheckExternalInstanceReq req)
                                throws Exception
```
    校验三方审批实例，调用该接口校验三方审批实例数据，用于判断服务端数据是否为最新的。请求时提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 ID。;;例如，设置定时任务每隔 5 分钟，将最近 5 分钟产生的实例使用该接口进行对比。如果数据在服务端不存在或者不是最新，则可以根据本接口返回的实例 ID、任务 ID，前往[同步三方审批实例](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/create)。
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=check&project=approval&resource=external_instance&version=v4 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/approvalv4/CheckExternalInstanceSample.java ;
    
    抛出:
    
    Exception
  - create
```
public CreateExternalInstanceResp create(CreateExternalInstanceReq req,
                                         RequestOptions reqOptions)
                                  throws Exception
```
    同步三方审批实例，审批中心不负责审批的流转，审批的流转在三方系统。本接口用于把三方系统在审批流转后生成的审批实例、审批任务、审批抄送数据同步到审批中心。
    需确保审批实例内各类实体（实例、任务、抄送） ID 在审批实例内的唯一性，不属于同一实体之间的 ID 也要确保唯一性。如果实例 ID、任务 ID、抄送 ID 重复，则会导致在审批中心任务看不到对应的审批数据。;;## 实现效果;;调用本接口同步三方审批实例后，企业员工可以在审批中心浏览同步过来的审批实例、任务、抄送信息，并可以跳转回三方系统查看和操作审批，其中，实例信息在审批中心的 **已发起** 列表、任务信息在 **待办** 和 **已办** 列表、抄送信息在 **抄送我** 列表。;;:::html;;:::;;[创建三方审批定义](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_approval/create)时如果设置了三方审批回调 URL，对于审批任务，可以配置[三方快捷审批回调](https://open.feishu.cn/document/ukTMukTMukTM/ukjNyYjL5YjM24SO2IjN/quick-approval-callback)，这样审批人可以在审批中心直接进行审批操作，审批中心会将审批结果回调至三方系统，三方系统收到回调后更新任务信息，并将新的任务信息同步回审批中心，形成闭环。;;:::html;;:::; ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=approval&resource=external_instance&version=v4 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/approvalv4/CreateExternalInstanceSample.java ;
    
    抛出:
    
    Exception
  - create
```
public CreateExternalInstanceResp create(CreateExternalInstanceReq req)
                                  throws Exception
```
    同步三方审批实例，审批中心不负责审批的流转，审批的流转在三方系统。本接口用于把三方系统在审批流转后生成的审批实例、审批任务、审批抄送数据同步到审批中心。
    需确保审批实例内各类实体（实例、任务、抄送） ID 在审批实例内的唯一性，不属于同一实体之间的 ID 也要确保唯一性。如果实例 ID、任务 ID、抄送 ID 重复，则会导致在审批中心任务看不到对应的审批数据。;;## 实现效果;;调用本接口同步三方审批实例后，企业员工可以在审批中心浏览同步过来的审批实例、任务、抄送信息，并可以跳转回三方系统查看和操作审批，其中，实例信息在审批中心的 **已发起** 列表、任务信息在 **待办** 和 **已办** 列表、抄送信息在 **抄送我** 列表。;;:::html;;:::;;[创建三方审批定义](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_approval/create)时如果设置了三方审批回调 URL，对于审批任务，可以配置[三方快捷审批回调](https://open.feishu.cn/document/ukTMukTMukTM/ukjNyYjL5YjM24SO2IjN/quick-approval-callback)，这样审批人可以在审批中心直接进行审批操作，审批中心会将审批结果回调至三方系统，三方系统收到回调后更新任务信息，并将新的任务信息同步回审批中心，形成闭环。;;:::html;;:::; ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=approval&resource=external_instance&version=v4 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/approvalv4/CreateExternalInstanceSample.java ;
    
    抛出:
    
    Exception

类 ExternalInstance

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

ExternalInstance

方法详细资料

check

check

create

create