## 接口说明
该接口按审批模板(process_code)+ 时间范围,游标分页返回审批实例 ID 列表,是钉钉审批数据集成的第一步:先拿 ID 列表,再用 topapi/processinstance/get 逐个拉实例详情(表单组件值、审批记录、状态)。典型场景:费用报销单同步到 ERP 生成应付/凭证,采购申请同步生成采购订单,实现 OA 到业财的打通。
### 请求要点
1. POST + application/json,access_token 放 URL query;body 为 JSON。
2. body 参数:process_code(审批模板编码,必填)、start_time(毫秒时间戳,必填)、end_time(可选,与 start 间隔不超过 120 天)、size(每页 ≤20)、cursor(游标,首页 0)。
3. 响应 result.list 为实例 ID 数组,has_more 判断是否继续翻页;next_cursor 作为下一页 cursor。
4. 单次时间窗口最大 120 天,历史数据回补按月切片;增量同步以 start_time 为游标并重叠数分钟。
### 集成建议
- 表单组件值在实例详情 form_component_values 中,组件 label/value 随模板版本变化,映射配置建议做成可维护的字典,而不是硬编码下标。
- 轻易云对钉钉审批的同步以 process_instance_id 为幂等键,配合状态(status:COMPLETED/TERMINATED)过滤,只把审批通过的单据写入 ERP。