目前，宜搭已经将 OpenAPI 全部上架到了钉钉开放平台, 但是仍然会保留宜搭OpenAPI调用(旧) （后续会逐步移除epaas宜搭OpenAPI说明文档，注意: 仅仅是移除说明文档）。通过钉钉开放平台调用宜搭 OpenAPI 是更好的选择。

当前文档是 epaas 宜搭 OpenAPI，不再建议通过 epaas 访问宜搭 OpenAPI。

通过钉钉开放平台调用宜搭 OpenAPI 请参考 宜搭Open API开放接口

​

手把手教程：

1. 准备工作

第一步：申请秘钥授权

目前宜搭已接入钉钉开放平台，优先走 钉钉开放平台接口，无需申请秘钥授权。如因钉钉平台无法调用或其他特别原因，可以钉钉联系技术支持-康健（钉钉号：kangjianoops）给予帮助和指引。

第二步：参考案例完成请求调用

demo 参考：下载样例项目 获取的应用 accessKey 和 secretKey 填入gateway.properties 配置文件中。样例项目是独立的 Spring boot 项目，用户根据需求做取舍。

1.1 Java调用方式

(1)引入依赖

手动JAR包依赖

其他依赖

前置审批人根据用户需求设置，需要程序回调执行的审批人需要选择使用角色中的虚拟角色「宜搭平台」，选择完成之后点击「保存」按钮，保存当前最新添加的流程节点。

回到流程设置的最外层，点击「保存并发布」按钮，将整个流程发布

发起流程之后，一路处理，直到审批流到达「宜搭平台」，此时整个流程会卡主，等待这一虚拟角色的审批

可以调用宜搭暴露的「执行虚拟节点任务」的接口 /yida/process/executePlatformTask.json 来更新该审批节点的处理结果。

相关参数调用 Demo 如下：

这里重点介绍一下其中的流程实例Id参数proInstId，它表示的是一个审批流的实例，获取方式之一为根据「根据条件搜索流程实例Id」的接口 /yida/process/getInstanceIds.json 接口，设置查询字段 instanceStatus 为RUNNING 以及 searchFieldJson 中某个字段值来搜索到达「宜搭平台」处理的审批节点。

使用虚拟节点而不是某一个真实存在的审批人是保证该审批处理一定是接口侧发起的，系统中的登录人是无法直接执行该审批，提供一个安全性的保障。

日期区间在数据管理里自动生成日期区间开始和日期区间结束这个2个组件，各自的操作符为介于，也即日期区间的开始时间介于和日期区间的结束时间介于

​

[{