批量获取审批单号

POST

http://127.0.0.1/cgi-bin/oa/getapprovalinfo

第三方应用开发/OA/审批

最后修改时间：2022-08-30 03:03:37

责任人：未设置

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

第三方应用开发者可通过安装在企业的第三方应用的AccessToken调用此接口，以获取授权企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。第三方应用必须开启授权审批接口权限。

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

推荐使用此接口获取审批数据，旧接口后续将不再维护。
1 接口频率限制 600次/分钟
2 请求的参数endtime需要大于startime，起始时间跨度不能超过31天；

错误说明：

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

文档ID: 17676
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/91816

请求参数

Query 参数

access_token

string

必需

调用接口凭证。必须使用审批应用或企业内自建应用的secret获取

示例值:

Body 参数application/json

cursor

integer <int32>

必需

分页查询游标，默认为0，后续使用返回的next_cursor进行分页拉取

size

integer <int32>

必需

一次请求拉取审批单数量，默认值为100，上限值为100。若accesstoken为自建应用，仅允许获取在应用可见范围内申请人提交的表单，返回的sp_no_list个数可能和size不一致，开发者需用next_cursor判断表单记录是否拉取完

endtime

string

必需

审批单提交的时间范围，结束时间，Unix时间戳

starttime

string

必需

审批单提交的时间范围，开始时间，UNix时间戳

filters

array [object {2}]

可选

筛选条件，可对批量拉取的审批申请设置约束条件，支持设置多个条件

value

string

可选

筛选值，对应为：template_id-模板id；creator-申请人userid ；department-所在部门id；sp_status-审批单状态（1-审批中；2-已通过；3-已驳回；4-已撤销；6-通过后撤销；7-已删除；10-已支付）

key

string

可选

筛选类型，包括： template_id - 模板类型/模板id； creator - 申请人； department - 审批单提单者所在部门； sp_status - 审批状态; record_type - 审批单类型属性，1-请假；2-打卡补卡；3-出差；4-外出；5-加班； 6- 调班；7-会议室预定；8-退款审批；9-红包报销审批注意: 1、仅“部门”支持同时配置多个筛选条件。 2、不同类型的筛选条件之间为“与”的关系，同类型筛选条件之间为“或”的关系 3、record_type筛选类型仅支持2021/05/31以后新提交的审批单，历史单不支持表单类型属性过滤

示例

{
  "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"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/oa/getapprovalinfo?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

sp_no_list

array[string]

必需

审批单号列表，包含满足条件的审批申请

示例

{
  "errcode": 0,
  "errmsg": "string",
  "sp_no_list": [
    "string"
  ]
}

提交审批申请

获取审批申请详情