获取审批数据（旧）

提示：推荐使用新接口“批量获取审批单号”及“获取审批申请详情”，此接口后续将不再维护、逐步下线。

通过本接口来获取公司一段时间内的审批记录。一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

获取审批记录请求参数endtime需要大于startime，同时起始时间跨度不要超过30天；

一次请求返回的审批记录上限是100条，超过100条记录请使用next_spnum进行分页拉取。

返回数据注解：

【注解1】请假、报销的新数据格式：
近期版本对企业微信请假、报销数据进行了兼容升级，以支持模板字段的自定义。因此，除了提供请假、报销的历史格式数据外，还在“apply_data”中提供了与自定义模板一致的新格式数据。
建议开发者后续统一使用“apply_data”获取审批模板数据，以确保数据准确无误。

近期对于“APPLY_DATA”优化，导致“APPLY_DATA”数据结构发生变化，短时间内会存在新老两种数据格式，判断的时候可以根据“APPLY_DATA”是否是对象还是数组进行判断是老的结构还是新的。

【注解2】apply_data：

【注解2】apply_data：{    "item-1490450365815": {        "title": "加班理由",        // 控件名称        "type": "textarea",         // 控件类型【包括：1.text:文本；2.textarea:多行文本；3.number:数字；4.date:日期；5.datehour:日期+时间；6.file:附件；7.price:金额；8.select:单选；9.checkbox:多选；10.tips:说明文字；11.list:明细；12.expenseAmount:总金额 】        "value": "项目需要"     // 填写的内容，只有Type是图片时，value是一个数组，数据示例如下方所示；    },    "item-1490450379069": {        "title": "加班开始时间",        "type": "date",        "value": "1490371200000"    //日期格式为时间缀    },    "item-1490450399494": {        "title": "加班证明",        "type": "image",        "value": [                    "https://p.qpic.cn/pic_wework/4116602740/a2a481aa4e87639055774e51bc6cabde5595cd4458b57343/0",                    "https://p.qpic.cn/pic_wework/4116602740/a2a481aa4e87639055774e51bc6cabde5595cd4458b57343/0"                ]    }}

【注解3】新applydata结构

【注解3】新apply_data：[    {        id: "item-1490450365815",        type: "textarea",        value: "项目需要",        title:"加班理由"    },    {    id: "item-1490450379069",        type: "date",        value: "1490371200000",        title:"加班时间"    }]

【注解4】无法获取管理员已删除的审批单数据

附：时间段内审批单数量超过100时
当时间段内审批单超过100时，可通过填写next_spnum的值，从而多次拉取列表的方式来满足需求，但调用频率不可超过600次/分。
具体而言，就是在调用接口时，将上一次调用得到的返回中的next_spnum值，作为下一次调用中的next_spnum值。

返回码：
301025 参数非法
301026 获取数据失败

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "count": 3,
    "total": 5,
    "next_spnum": 201704240001,
    "data": [
        {
            "spname": "报销",
            "apply_name": "报销测试",
            "apply_org": "报销测试企业",
            "approval_name": [
                "审批人测试"
            ],
            "notify_name": [
                "抄送人测试"
            ],
            "sp_status": 1,
            "sp_num": 201704200001,
            "mediaids": [
                "WWCISP_G8PYgRaOVHjXWUWFqchpBqqqUpGj0OyR9z6WTwhnMZGCPHxyviVstiv_2fTG8YOJq8L8zJT2T2OvTebANV-2MQ"
            ],
            "apply_time": 1499153693,
            "apply_user_id": "testuser",
            "expense": {
                "expense_type": 1,
                "reason": "",
                "item": [
                    {
                        "expenseitem_type": 6,
                        "time": 1492617600,
                        "sums": 9900,
                        "reason": ""
                    }
                ]
            },
            "comm": {
                "apply_data": "{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
            }
        },
        {
            "spname": "请假",
            "apply_name": "请假测试",
            "apply_org": "请假测试企业",
            "approval_name": [
                "审批人测试"
            ],
            "notify_name": [
                "抄送人测试"
            ],
            "sp_status": 1,
            "sp_num": 201704200004,
            "apply_time": 1499153693,
            "apply_user_id": "testuser",
            "leave": {
                "timeunit": 0,
                "leave_type": 4,
                "start_time": 1492099200,
                "end_time": 1492790400,
                "duration": 144,
                "reason": ""
            },
            "comm": {
                "apply_data": "{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
            }
        },
        {
            "spname": "自定义审批",
            "apply_name": "自定义",
            "apply_org": "自定义测试企业",
            "approval_name": [
                "自定义审批人"
            ],
            "notify_name": [
                "自定义抄送人"
            ],
            "sp_status": 1,
            "sp_num": 201704240001,
            "apply_time": 1499153693,
            "apply_user_id": "testuser",
            "comm": {
                "apply_data": "{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
            }
        }
    ]
}

提示：推荐使用新接口“批量获取审批单号”及“获取审批申请详情”，此接口后续将不再维护、逐步下线。#

请求参数

请求示例代码

返回响应

提示：推荐使用新接口“批量获取审批单号”及“获取审批申请详情”，此接口后续将不再维护、逐步下线。