审批应用及有权限的自建应用,可通过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" : "1"
},
{
"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 | 批量拉取审批单内部接口失败 |