目录
可调用本接口更新审批模板。更新模板后,管理后台及审批应用内将更新原模板的内容,已配置的审批流程和规则不变。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/oa/approval/update_template?access_token=ACCESS_TOKEN
请求示例:
{
"template_id": "TEMPLATE_ID",
"template_name": [{
"text": "我的api测试模版",
"lang": "zh_CN"
}],
"template_content": {
"controls": [{
"property": {
"control": "Selector",
"id": "Selector-01",
"title": [{
"text": "多选控件名称",
"lang": "zh_CN"
}],
"placeholder": [{
"text": "多选控件说明",
"lang": "zh_CN"
}],
"require": 0,
"un_print": 1
},
"config":{
"selector": {
"type": "multi",
"options": [
{
"key": "option-1",
"value":{
"text":"选项1",
"lang":"zh_CN"
}
},
{
"key": "option-2",
"value":{
"text":"选项2",
"lang":"zh_CN"
}
}
]
}
}
},
{
"property": {
"control": "Text",
"id": "Text-01",
"title": [{
"text": "文本控件名称",
"lang": "zh_CN"
}],
"placeholder": [{
"text": "文本控件说明",
"lang": "zh_CN"
}],
"require": 0,
"un_print": 1
},
"config":{
}
}]
}
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证。必须使用审批应用或企业内自建应用的secret获取,获取方式参考:文档-获取access_token |
template_id | 是 | 模版id |
template_name | 是 | 模版名称数组 |
└ text | 是 | 模版名称。需满足以下条件:1-模版名称不得和现有模版名称重复;2-长度不得超过40个字符。 |
└ lang | 是 | 显示语言,中文:zh_CN(注意不是zh-CN) |
template_content | 是 | 审批模版控件设置,可以参考创建审批模板一节 template_content 参数说明 |
注意:
1. 当模板的控件为必填属性时,表单中对应的控件必须有值。
2. 一个模版中只能拥有一类假勤控件类型,Vacation-假期;Attendance-外出/出差/加班 均为假勤控件类型。
权限说明
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「审批 - 可调用接口的应用」中 |
代开发应用 | 具有「审批」权限 |
第三方应用 | 暂不支持 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果:
{
"errcode":0,
"errmsg":"ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码,详情见错误码说明 |
errmsg | 错误码对应的错误信息提示 |
错误码 | 说明 |
---|---|
301088 | 无审批应用权限 |
301086 | 审批控件参数错误 |
301087 | 企业模版数超过上限 |
301115 | 模板已配置自定义打印格式,不支持API修改模板 |
620004 | 服务器内部错误 |
-1 | 未知错误 |