批量获取审批单号 - 企业微信API

审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
自建应用调用此接口，需在“管理后台-应用管理-审批-API-审批数据权限”中，授权应用允许提交审批单据。

一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

推荐使用此接口获取审批数据，旧接口后续将不再维护。

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/getapprovalinfo?access_token=ACCESS_TOKEN

请求示例：

{
    "starttime" : "1569546000",
    "endtime" : "1569718800",
    "cursor" : 0 ,
    "size" : 100 ,
    "filters" : [
        {
            "key": "template_id",
            "value": "ZLqk8pcsAoaXZ1eY56vpAgfX28MPdYU3ayMaSPHaaa"
        },
        {
            "key" : "creator",
            "value" : "WuJunJie"
        },
        {
            "key" : "department",
            "value" : "1688852032415111"
        },       
        {
            "key" : "sp_status",
            "value" : "1"
        }     
    ]
}

参数说明：

参数	必须	说明
access_token	是	调用接口凭证。必须使用审批应用或企业内自建应用的secret获取，获取方式参考：文档-获取access_token
starttime	是	审批单提交的时间范围，开始时间，UNix时间戳
endtime	是	审批单提交的时间范围，结束时间，Unix时间戳
cursor	是	分页查询游标，默认为0，后续使用返回的next_cursor进行分页拉取
size	是	一次请求拉取审批单数量，默认值为100，上限值为100
filters	否	筛选条件，可对批量拉取的审批申请设置约束条件，支持设置多个条件
└ key	否	筛选类型，包括： template_id - 模板类型/模板id； creator - 申请人； department - 审批单提单者所在部门； sp_status - 审批状态。注意: 仅“部门”支持同时配置多个筛选条件。不同类型的筛选条件之间为“与”的关系，同类型筛选条件之间为“或”的关系
└ value	否	筛选值，对应为：template_id-模板id；creator-申请人userid ；department-所在部门id；sp_status-审批单状态（1-审批中；2-已通过；3-已驳回；4-已撤销；6-通过后撤销；7-已删除；10-已支付）

1 接口频率限制 600次/分钟
2 请求的参数endtime需要大于startime，起始时间跨度不能超过31天；

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "sp_no_list": [
        "201909270001",
        "201909270002",
        "201909270003"
    ]
}

参数说明：

参数	说明
sp_no_list	审批单号列表，包含满足条件的审批申请
next_cursor	后续请求查询的游标，当返回结果没有该字段时表示审批单已经拉取完

错误说明

错误码	说明
301055	无审批应用数据拉取权限
301025	请求参数错误
301026	批量拉取审批单内部接口失败