获取审批申请详情

企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。
服务商可通过第三方应用Secret调用本接口，根据审批单号查询企业微信“审批应用”中，由第三方应用添加模板所提交的审批申请详情。

接口频率限制 600次/分钟

附录：各控件apply_data/contents/value参数介绍

附1 文本/多行文本控件（control参数为Text或Textarea）

{    "text": "文本填写的内容"}

参数	说明
text	文本内容，即申请人在此控件填写的文本内容

附2 数字控件（control参数为Number）

{    "new_number": "700"}

参数	说明
new_number	数字内容，即申请人在此控件填写的数字内容

附3 金额控件（control参数为Money）

{    "new_money": "700"}

参数	说明
new_money	金额内容，即申请人在此控件填写的金额内容

附4 日期/日期+时间控件（control参数为Date）

{    "date": {        "type": "day",        "s_timestamp": "1569859200"    }}

参数	说明
date	日期/日期+时间内容，即申请人在此控件选择的日期/日期+时间内容
└ type	时间展示类型：day-日期；hour-日期+时间
└ s_timestamp	时间戳，字符串类型

附5 单选/多选控件（control参数为Selector）

{    "selector": {        "type": "multi",        "options": [            {                "key": "option-15111111111",                "value": [                    {                        "text": "选项1",                        "lang": "zh_CN"                    }                ]            },            {                "key": "option-15222222222",                "value": [                    {                        "text": "选项2",                        "lang": "zh_CN"                    }                ]            }        ]    }}

参数	说明
selector	选择内容，即申请人在此控件选择的选项内容
└ type	选择类型：single-单选；multi-多选
└ options	申请人所选择的选项，多选情况下可能有多个（仅包含申请人说选择的选项，并非所有选项，若需要了解所有选项，需使用“获取审批模板详情”接口）
└ └ key	选项key，选项的唯一id，可通过“获取审批模板详情”接口获得
└ └ value	选项值，若配置了多语言则会包含中英文的选项值

附6 成员控件（control参数为Contact，且value参数为members）

{    "members": [        {            "userid": "WuJunJie",            "name": "Jackie"        },        {            "userid": "WangXiaoMing"            "name": "Tom"        }    ]}

参数	说明
members	成员内容，即申请人在此控件选择的成员，多选模式下可能有多个
└ userid	成员的userid
└ name	成员名

附7 部门控件（control参数为Contact，且value参数为departments）

{    "departments": [        {            "openapi_id": "2",            "name": "销售部",        },        {            "openapi_id": "3",            "name": "生产部",        }    ]}

参数	说明
departments	部门内容，即申请人在此控件选择的部门，多选模式下可能有多个
└ openapi_id	部门id
└ name	部门名

附8 说明文字控件（control参数为Tips）
此控件不显示在审批详情中，故value为空

附9 附件控件（control参数为File）

{    "files": [        {            "file_id": "WWCISP_v2z8qZENw2qwSiNroVKykbxxMXvmI1lELzG-fo25Y9n1duozezKEu6zSIvOHPCd9_8s934AJncRz5f9G4E_nCQonUHLdiAnCLjfZQQwVaiG7krKzyGB1MpYa9ZVkk0gQ7P8HvO_SOdwzLwpyUZ3Tm2ApyoO_78nTM-iEkf_TILqXuYxKd7ByYL34wMA9Czf6Iy151tHbcYNvbNZZHTnL4UMQdohJ_MPYA2Wz00IebZb3_UuIk5MdJSH_IKlZn9Ms5"        },        {            "file_id": "WWCISP_gZ3BMg5hwI1Adi16NwzJgpi9zp6QQjMdYcuemVWBeHnmMK3QJOYiIIkHvRIh0ysZcAo6gJp069o5tx7qxVzin1Q9LKswff624E1qCCmt088ISBVPScoqEiG4YTI_Kltrqn7b0wvMTudd9lIE3ywgHatPRWKxsHNsSxEY_FuaFWlGHzxcYKNq_LIfVBXZGji-C5bXp23MwpTcCXYfWPfSEpEeXW5c5sQscY_MeW5uc0gITpeFKFXARXmKC62_u7Ln"        }    ]}

参数	说明
files	文件内容，即申请人在此控件上传的文件内容，可能有多个
└ file_id	文件的media_id，具体使用请参考：文档-获取临时素材

附10 明细控件（control参数为Table）

{    "children": [        {            "list": [                {                    "control": "Text",                    "id": "Text-15111111111",                    "title": [                        {                            "text": "明细内文本控件",                            "lang": "zh_CN"                        }                    ],                    "value": {                        "text": "明细文本"                    }                }            ]        }    ]}

参数	说明
children	明细内容，一个明细控件可能包含多个子明细
└ list	子明细列表，包含了申请人在子明细的所有子控件中填写的内容，子控件的数据接口同一般控件

附11 假勤组件-请假组件（control参数为Vacation）

{    "vacation": {        "selector": {            "type": "single",            "options": [                {                    "key": "3",                    "value": [                        {                            "text": "病假",                            "lang": "zh_CN"                        }                    ]                }            ],            "exp_type": 0        },        "attendance": {            "date_range": {                "type": "hour",                "new_begin": 1568077200,                "new_end": 1568368800,                "new_duration": 291600            },            "type": 1        }    }}

参数	说明
vacation	请假内容，即申请人在此组件内选择的请假信息
└ selector	请假类型，所选选项与假期管理关联，为假期管理中的假期类型
└ └ type	选择类型：single-单选；multi-多选，在假勤控件中固定为单选
└ └ options	用户所选选项
└ └ └ key	选项key，选项的唯一id，可通过“获取审批模板详情”接口获得
└ └ └ value	选项值，若配置了多语言则会包含中英文的选项值
└ attendance	假勤组件
└ └ date_range	假勤组件时间选择范围
└ └ └ type	时间展示类型：day-日期；hour-日期+时间
└ └ └ new_begin	开始时间
└ └ └ new_end	结束时间
└ └ └ new_duration	请假时长
└ └ type	假勤组件类型：1-请假；2-补卡；3-出差；4-外出；5-加班

附12 假勤组件-出差/外出/加班组件（control参数为Attendance）

{    "attendance": {        "date_range": {            "type": "halfday",            "new_begin": 1570550400,            "new_end": 1570593600,            "new_duration": 86400        },        "type": 4    }}

参数	说明
attendance	假勤内容，即申请人在此组件内选择的假勤信息
└ date_range	假勤组件时间选择范围
└ └ type	时间展示类型：day-日期；hour-日期+时间
└ └ new_begin	开始时间，unix时间戳
└ └ new_end	结束时间，unix时间戳
└ └ new_duration	出差/外出/加时长，单位秒
└ type	假勤组件类型：1-请假；2-补卡；3-出差；4-外出；5-加班

附13 补卡组件（control参数为PunchCorrection）

{    "punch_correction": {        "state":"迟到"，        "time":1570550400    }}

参数	说明
punch_correction	补卡信息
└ state	异常状态说明
└ time	补卡时间，Unix时间戳

附14 时长组件（control参数为DateRange）

{    "date_range": {        "type": "halfday",        "new_begin": 1570550400,        "new_end": 1570593600,        "new_duration": 86400    }}

参数	说明
date_range	时长组件
└ type	时间展示类型：day-日期；hour-日期+时间
└ new_begin	开始时间,unix时间戳
└ new_end	结束时间，unix时间戳
└ new_duration	时长范围，单位秒

错误说明

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

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

info

object

必需

sp_no

string

审批编号

必需

sp_name

string

必需

审批申请类型名称（审批模板名称）

sp_status

integer

必需

申请单状态：1-审批中；2-已通过；3-已驳回；4-已撤销；6-通过后撤销；7-已删除；10-已支付

template_id

string

必需

审批模板id。可在“获取审批申请详情”、“审批状态变化回调通知”中获得，也可在审批模板的模板编辑页面链接中获得。

apply_time

integer

必需

审批申请提交时间,Unix时间戳

applyer

object

申请人信息

必需

sp_record

array [object {3}]

必需

审批流程信息，可能有多个审批节点。

notifyer

array [object {1}]

必需

抄送信息，可能有多个抄送节点

apply_data

object

审批申请数据

必需

comments

array [object {5}]

必需

审批申请备注信息，可能有多个备注节点

示例

{
  "errcode": 0,
  "errmsg": "string",
  "info": {
    "sp_no": "string",
    "sp_name": "string",
    "sp_status": 0,
    "template_id": "string",
    "apply_time": 0,
    "applyer": {
      "userid": "string",
      "partyid": "string"
    },
    "sp_record": [
      {
        "sp_status": 0,
        "approverattr": 0,
        "details": [
          {
            "approver": {
              "userid": "string"
            },
            "speech": "string",
            "sp_status": 0,
            "sptime": 0,
            "media_id": [
              "string"
            ]
          }
        ]
      }
    ],
    "notifyer": [
      {
        "userid": "string"
      }
    ],
    "apply_data": {
      "contents": [
        {
          "control": "string",
          "id": "string",
          "title": [
            {
              "text": "string",
              "lang": "string"
            }
          ],
          "value": {
            "text": "string",
            "tips": [
              "string"
            ],
            "members": [
              "string"
            ],
            "departments": [
              "string"
            ],
            "files": [
              "string"
            ],
            "children": [
              "string"
            ],
            "stat_field": [
              "string"
            ]
          }
        }
      ]
    },
    "comments": [
      {
        "commentUserInfo": {
          "userid": "string"
        },
        "commenttime": 0,
        "commentcontent": "string",
        "commentid": "string",
        "media_id": [
          "string"
        ]
      }
    ]
  }
}

附录：各控件apply_data/contents/value参数介绍#

错误说明#

请求参数

示例代码

返回响应

附录：各控件apply_data/contents/value参数介绍

错误说明