获取审批模板详情

企业可通过审批应用或自建应用Secret调用本接口，获取企业微信“审批应用”内指定审批模板的详情。
较早时间创建的模板，id为类似“1910324946027731_1688852032423522_1808577376_15111111111”的数字串。

1.审批应用的Secret可获取企业自建模板及第三方服务商添加的模板详情；自建应用的Secret可获取企业自建模板的模板详情。
2.接口调用频率限制为600次/分钟。

附录

附1：Date控件（日期/日期+时间控件）config说明：

{    "date": {        "type": "day"    }}

参数	说明
date	类型标志，日期/日期+时间控件的config中会包含此参数
└ type	时间展示类型：day-日期；hour-日期+时间

附2：Selector控件（单选/多选控件）config说明：

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

参数	说明
selector	类型标志，单选/多选控件的config中会包含此参数
└ type	选择类型：single-单选；multi-多选
└ options	选项，包含单选/多选控件中的所有选项，可能有多个
└ └ key	选项key，选项的唯一id，可用于发起审批申请，为单选/多选控件赋值
└ └ value	选项值，若配置了多语言则会包含中英文的选项值，默认为zh_CN中文

附3：Contact控件（成员/部门控件）config说明：

{    "contact": {        "type": "multi",        "mode": "department"    }}

参数	说明
contact	类型标志，单选/多选控件的config中会包含此参数
└ type	选择方式：single-单选；multi-多选
└ mode	选择对象：user-成员；department-部门

附4：Table（明细控件）config说明：

{    "table": {        "children": [            {                "property": {                    "control": "Text",                    "id": "Text-15111111111",                    "title": [                        {                            "text": "明细内文本控件",                            "lang": "zh_CN"                        }                    ],                    "placeholder": [                        {                            "text": "这是明细内文本控件的说明",                            "lang": "zh_CN"                        }                    ],                    "require": 0,                    "un_print": 0                }            }        ],        "stat_field": []    }}

参数	说明
table	类型标志，明细控件的config中会包含此参数
└ children	明细内的子控件，内部结构同controls

附5：Attendance控件（假勤控件）config说明：
说明:【出差】【加班】【外出】模板特有的控件

{    "attendance": {        "date_range": {            "type": "hour"        },        "type": 3    }}

参数	说明
attendance	类型标志，假勤控件的config中会包含此参数
└ date_range	假期控件属性
└└ type	时间刻度：hour-精确到分钟, halfday—上午/下午
└ type	假勤控件类型：1-请假，3-出差，4-外出，5-加班

附6：Vacation控件（假勤控件）说明：
说明:【请假】模板特有控件, 请假类型强关联审批应用中的假期管理。

{    "vacation_list": {        "item": [{            "id": 1,            "name": [{                "text": "年假",                "lang": "zh_CN"            }]        }, {            "id": 2,            "name": [{                "text": "事假",                "lang": "zh_CN"            }]        }        ...//省略         ]    }}

参数	说明
vacation_list	假期类型数组
└ item	单个假期类型属性
└└ id	假期类型标识id
└└ name	假期类型名称，默认zh_CN中文名称

错误说明

错误码	说明
301025	参数错误，请求template_id非法
301026	通用错误码，拉取审批模板内部接口失败

文档ID: 18596
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/91982
https://open.work.weixin.qq.com/api/doc/90001/90143/92631

请求参数

Query 参数

access_token

string

必需

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

示例值:

Body 参数application/json

template_id

string

必需

模板的唯一标识id。可在“获取审批单据详情”、“审批状态变化回调通知”中获得，也可在审批模板的模板编辑页面浏览器Url链接中获得。

示例

{
  "template_id": "ZLqk8pcsAoXZ1eYa6vpAgfX28MPdYU3ayMaSPHaaa"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

template_names

array [object {2}]

必需

模板名称，若配置了多语言则会包含中英文的模板名称，默认为zh_CN中文

text

string

可选

lang

string

可选

template_content

object

模板控件信息

必需

controls

array [object {2}]

必需

模板控件数组。模板详情由多个不同类型的控件组成，控件类型详细说明见附录。

示例

{
  "errcode": 0,
  "errmsg": "string",
  "template_names": [
    {
      "text": "string",
      "lang": "string"
    }
  ],
  "template_content": {
    "controls": [
      {
        "property": {
          "control": "string",
          "id": "string",
          "title": [
            {
              "text": "string",
              "lang": "string"
            }
          ],
          "placeholder": [
            {
              "text": "string",
              "lang": "string"
            }
          ],
          "require": 0,
          "un_print": 0
        },
        "config": {
          "selector": {
            "type": "string",
            "exp_type": 0,
            "options": [
              {
                "key": "string",
                "value": [
                  {
                    "text": "string",
                    "lang": "string"
                  }
                ]
              }
            ]
          }
        }
      }
    ]
  }
}

附录#

错误说明#

请求参数

示例代码

返回响应

附录

错误说明