企业内部开发 服务端API OA 汇报 批量获取汇报记录单号
批量获取汇报记录单号

企业可通过access_token调用本接口,以获取企业一段时间内企业微信“汇报应用”汇报记录编号,支持按汇报表单ID、申请人、部门等条件筛选。

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

表单ID的获取方式:
管理后台--汇报应用--某个汇报的内容设置页--点击“汇报名称”,即可获取

 

请求方式:POST(HTTPS)

请求地址: https://qyapi.weixin.qq.com/cgi-bin/oa/journal/get_record_list?access_token=ACCESS_TOKEN

请求示例

{
    "starttime": 1606230000,
    "endtime": 1606361304,
    "cursor": 0,
    "limit": 10,
    "filters": [
        {
            "key": "creator",
            "value": "kele"
        },
        {
            "key": "department",
            "value": "1"
        },
        {
            "key": "template_id",
            "value": "3TmALk1ogfgKiQE3e3jRwnTUhMTh8vca1N8zUVNUx"
        }
    ]
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证
starttimeuint32开始时间
endtimeuint32结束时间,开始时间和结束时间间隔不能超过一个月
cursoruint32游标首次请求传0,非首次请求携带上一次请求返回的next_cursor
limituint32拉取条数
filtersobj[]过滤条件
filters.keystring-
不多于256字节,creator指定汇报记录提单人;department指定提单人所在部门;template_id指定模板
filters.valuestring-
不多于256字节

 

权限说明: (无特殊权限)

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "journaluuid_list": [
        "41eJejN57EJNzr8HrZfmKyCN7xwKw1qRxCZUxCVuo9fsWVMSKac6nk4q8rARTDaVNdg",
        "41eJejN57EJNzr8HrZfmKy7rmnZS5HGzpqUefyqCRhjdY9GWQQ6gcaNfaW6GPAdG5cg",
        "41eJejN57EJNzr8HrZfmKy2mkwnjMJPgE6UZfqnW5qMeZ1ag3qr1Amb98DbtVH89VJx",
        "41eJejN57EJNzr8HrZfmKyGXVp9cRByeSREpFtReMKpuAPYZYiCU4em8JKJNmCBYmxg",
        "41eJejN57EJNzr8HrZfmKy3NphvW9E8bYRTAMWcwo9oPhVEFv9cE2jUry8ZNsZYjuUx",
        "41eJejN57EJNzr8HrZfmKyDqJCnct6mYayM4tiEXGmoYmfUp1nDdNQSyxemtBHZa3ss",
        "41eJejN57EJNzr8HrZfmKyHr64ZdZa6JHYztDaS6hCmPMKtBN3YvD1FSFmauNU36Wxd",
        "41eJejN57EJNzr8HrZfmKyChHx58aDhGrvN7yKywBJs33yzUyqUF11sdBFcUBou2NQx",
        "41eJejN57EJNzr8HrZfmKy4w4AtPJyxQoGWmv7hnrZYwmdWVJQEhvgxT5mjEbC1xP43",
        "41eJejN57EJNzr8HrZfmKyFcSr1RLmAoBS7fnwiFcQJuVQfYZwcork67DZ36YFijmR2"
    ],
    "next_cursor": 34,
    "endflag": 0
}

 

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
journaluuid_liststring[]汇报记录id列表
next_cursoruint32下一次拉取游标
endflaguint320代表还有数据,1代表已无数据

 

错误说明

错误码说明
301065无汇报应用数据拉取权限
301066请求参数错误
301067接口内部失败
上一篇
概述
下一篇
获取汇报记录详情