获取审批数据（旧）

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

通过本接口来获取公司一段时间内的审批记录。一次拉取调用最多拉取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

请求参数

Query 参数

access_token

string

必需

调用接口凭证。必须使用审批应用的secret获取，获取方式参考：文档-获取access_token

示例值:

Body 参数application/json

endtime

integer <int32>

必需

获取审批记录的结束时间。Unix时间戳

starttime

integer <int32>

必需

获取审批记录的开始时间。Unix时间戳

next_spnum

number

可选

第一个拉取的审批单号，不填从该时间段的第一个审批单拉取

示例

{
  "starttime": 1492617600,
  "endtime": 1492790400,
  "next_spnum": 201704200003
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

count

integer

必需

拉取的审批单个数，最大值为100，当total参数大于100时，可运用next_spnum参数进行多次拉取

total

integer

必需

时间段内的总审批单个数

next_spnum

integer

必需

拉取列表的最后一个审批单号

data

array [object {13}]

必需

spname

string

必需

审批名称(请假，报销，自定义审批名称)

apply_name

string

必需

apply_org

string

申请人部门

必需

approval_name

array[string]

必需

notify_name

array[string]

抄送人姓名

必需

sp_status

integer

必需

审批状态：1审批中；2 已通过；3已驳回；4已取消；6通过后撤销；10已支付

sp_num

integer

审批单号

必需

mediaids

array[string]

可选

apply_time

integer

审批单提交时间

必需

apply_user_id

string

必需

审批单提交者的userid

expense

object

可选

报销类型（只有报销模板的审批记录有此数据项）

comm

object

审批模板信息

必需

leave

object

可选

请假类型(只有请假模板审批记录有此数据项)

示例

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

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

请求参数

示例代码

返回响应

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