企业微信开发----H5发送表单请求到企业微信内部审核
2024-06-06 15:04:03
最近有个业务需求是制作一个H5，把用户提交的退费申请发送到企业微信审核中心，让企业内部直接审核，大致看了下开发文档，也比较简单。感叹腾讯企业微信功能太强大了，就是一个企业OA
第一步 创建应用
这里就是应用的secret，复制保存。后期接口调用需要。
我的企业里页面拉到最下方，有个企业ID，这个后期接口要用也复制保存。
应用管理里面，点审批，新建一个审核，建好审核点进去URL最后一个参数就是 模板ID 复制保存，后期要用。至此所需主要开发接口参数已经完成，下面开始我们的接口开发。
第二步 接口开发
一 获取access_token
获取access_token是调用企业微信API接口的第一步，相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于access_token来鉴权调用者身份。
因此开发者，在使用业务接口前，要明确access_token的颁发来源，使用正确的access_token。
请求方式： GET（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
注：此处标注大写的单词ID和SECRET，为需要替换的变量，根据实际获取值更新。其它接口也采用相同的标注，不再说明。
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| corpid | 是 | 企业ID，获取方式参考：术语说明-corpid |
| corpsecret | 是 | 应用的凭证密钥，获取方式参考：术语说明-secret |
权限说明：
每个应用有独立的secret，获取到的access_token只能本应用使用，所以每个应用的access_token应该分开来获取
返回结果：
{"errcode": 0,"errmsg": "ok","access_token": "accesstoken000001","expires_in": 7200}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 出错返回码，为0表示成功，非0表示调用失败 |
| errmsg | 返回码提示语 |
| access_token | 获取到的凭证，最长为512字节 |
| expires_in | 凭证的有效时间（秒） |
注意事项：
开发者需要缓存access_token，用于后续接口的调用（注意：不能频繁调用gettoken接口，否则会受到频率拦截）。当access_token失效或过期时，需要重新获取。
access_token的有效期通过返回的expires_in来传达，正常情况下为7200秒（2小时），有效期内重复获取返回相同结果，过期后获取会返回新的access_token。
由于企业微信每个应用的access_token是彼此独立的，所以进行缓存时需要区分应用来进行存储。
access_token至少保留512字节的存储空间。
企业微信可能会出于运营需要，提前使access_token失效，开发者应实现access_token失效时重新获取的逻辑。
access_token.php 缓存access_token
<?php exit();?>{"access_token":"29_uoNmjFXbZDVZczklqDaQWl5jh3WuuRnluOEbCpTjkcUjrF1YF9v57kZtfPO8DFtwEK4YUYaeDnOIPJwXozDMHTMm43gF1zXZ4Wn86HnSZf9Ox2xH9_cXB3GqnpwIowF6NK_MPH0c3fyjjzkIBHKhADAWCF","expire_time":1577934448}获取access_token类
主要的功能就是调用接口获取access_token，第一次结果写入到access_token.php文件里面，以后从这个文件缓存里获取，如果缓存时间过了7000秒，那么就重新获取，避免接口调用上限制。
<?php
class WXSDK {private $appId;private $appSecret;public function __construct($appId, $appSecret) {$this->appId = $appId;//这里就是企业微信ID$this->appSecret = $appSecret;//这里就是你应用的secret$this->filePath = __DIR__.'/';} private function getAccessToken() {// access_token 应该全局存储与更新，以下代码以写入到文件中做示例$data = json_decode($this->get_php_file($this->filePath."access_token.php"));if ($data->expire_time < time()) {// 如果是企业号用以下URL获取access_token// $url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=$this->appId&corpsecret=$this->appSecret";$url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=$this->appId&corpsecret=$this->appSecret";$res = json_decode($this->httpGet($url),TRUE);$access_token = $res['access_token'];if ($access_token) {$data->expire_time = time() + 7000;$data->access_token = $access_token;$this->set_php_file($this->filePath."access_token.php", json_encode($data));}} else {$access_token = $data->access_token;}return $access_token;}private function httpGet($url) {$curl = curl_init();curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);curl_setopt($curl, CURLOPT_TIMEOUT, 500);// 为保证第三方服务器与微信服务器之间数据传输的安全性，所有微信接口采用https方式调用，必须使用下面2行代码打开ssl安全校验。// 如果在部署过程中代码在此处验证失败，请到 http://curl.haxx.se/ca/cacert.pem 下载新的证书判别文件。curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);curl_setopt($curl, CURLOPT_URL, $url);$res = curl_exec($curl);curl_close($curl);return $res;}private function get_php_file($filename) {return trim(substr(file_get_contents($filename), 15));}private function set_php_file($filename, $content) {$fp = fopen($filename, "w");fwrite($fp, "<?php exit();?>" . $content);fclose($fp);}
}//调用类
$wxsdk =new WXSDK($appid, $appsecret);
$wxconfig = $wxsdk->getAccessToken();二 发送企业审核
企业可通过审批应用或自建应用Secret调用本接口，代应用可见范围内员工在企业微信“审批应用”内提交指定类型的审批申请。
请求方式：POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/oa/applyevent?access_token=ACCESS_TOKEN
请求示例：
{"creator_userid": "WangXiaoMing","template_id": "3Tka1eD6v6JfzhDMqPd3aMkFdxqtJMc2ZRioeFXkaaa","use_template_approver":0,"choose_department":2,"approver": [{"attr": 2,"userid": ["WuJunJie","WangXiaoMing"]},{"attr": 1,"userid": ["LiuXiaoGang"]}],"notifyer":[ "WuJunJie","WangXiaoMing" ],"notify_type" : 1,"apply_data": {"contents": [{"control": "Text","id": "Text-15111111111","value": {"text": "文本填写的内容"}}]},"summary_list": [{"summary_info": [{"text": "摘要第1行","lang": "zh_CN"}]},{"summary_info": [{"text": "摘要第2行","lang": "zh_CN"}]},{"summary_info": [{"text": "摘要第3行","lang": "zh_CN"}]}]
}
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证。必须使用审批应用或企业内自建应用的secret获取，获取方式参考：文档-获取access_token |
| creator_userid | 是 | 申请人userid，此审批申请将以此员工身份提交，申请人需在应用可见范围内 |
| template_id | 是 | 模板id。可在“获取审批申请详情”、“审批状态变化回调通知”中获得，也可在审批模板的模板编辑页面链接中获得。暂不支持通过接口提交[打卡补卡][调班]模板审批单。 |
| use_template_approver | 是 | 审批人模式：0-通过接口指定审批人、抄送人（此时approver、notifyer等参数可用）; 1-使用此模板在管理后台设置的审批流程，支持条件审批。默认为0 |
| choose_department | 否 | 提单者提单部门id，不填默认为主部门 |
| approver | 是 | 审批流程信息，用于指定审批申请的审批流程，支持单人审批、多人会签、多人或签，可能有多个审批节点，仅use_template_approver为0时生效。 |
| └ userid | 是 | 审批节点审批人userid列表，若为多人会签、多人或签，需填写每个人的userid |
| └ attr | 是 | 节点审批方式：1-或签；2-会签，仅在节点为多人审批时有效 |
| notifyer | 否 | 抄送人节点userid列表，仅use_template_approver为0时生效。 |
| notify_type | 否 | 抄送方式：1-提单时抄送（默认值）； 2-单据通过后抄送；3-提单和单据通过后抄送。仅use_template_approver为0时生效。 |
| apply_data | 是 | 审批申请数据，可定义审批申请中各个控件的值，其中必填项必须有值，选填项可为空，数据结构同“获取审批申请详情”接口返回值中同名参数“apply_data” |
| └ contents | 是 | 审批申请详情，由多个表单控件及其内容组成，其中包含需要对控件赋值的信息 |
| └ └ control | 是 | 控件类型：Text-文本；Textarea-多行文本；Number-数字；Money-金额；Date-日期/日期+时间；Selector-单选/多选；；Contact-成员/部门；Tips-说明文字；File-附件；Table-明细；Location-位置；RelatedApproval-关联审批单；Formula-公式；DateRange-时长； |
| └ └ id | 是 | 控件id：控件的唯一id，可通过“获取审批模板详情”接口获取 |
| └ └ value | 是 | 控件值 ，需在此为申请人在各个控件中填写内容不同控件有不同的赋值参数，具体说明详见附录。模板配置的控件属性为必填时，对应value值需要有值。 |
| summary_list | 是 | 摘要信息，用于显示在审批通知卡片、审批列表的摘要信息，最多3行 |
| └ summary_info | 是 | 摘要行信息，用于定义某一行摘要显示的内容 |
| └ └ text | 是 | 摘要行显示文字，用于记录列表和消息通知的显示，不要超过20个字符 |
| └ └ lang | 是 | 摘要行显示语言 |
接口频率限制 600次/分钟
当模板的控件为必填属性时，表单中对应的控件必须有值。
返回结果：
{"errcode": 0,"errmsg": "ok","sp_no": "202001010001"
}
下面是服务器端代码：
//这里是H5表单提交过来的数据 要和你审核模板里面建的字段对应，对变量做下过滤验证，我这里就不写太详细，只是管理功能演示
$phone = isset($_POST['phone']) ? test_input($_POST['phone']) : 0;
$uname = test_input($_POST['uname']);
$school = test_input($_POST['school']);
$fee = test_input($_POST['fee']);
$reason = isset($_POST['reason']) ? test_input($_POST['reason']) : "-";
$course = isset($_POST['course']) ? test_input($_POST['course']) : "-";$arrdate = array("creator_userid"=>"这里是企业内部人员ID","template_id"=>"这里是你审核的模板ID","use_template_approver"=>0,"approver"=>array(0=>array("attr"=>2,"userid"=>array(0=>"审核人员ID")),1=>array("attr"=>1,"userid"=>array(0=>"审核人员ID"))),"notifyer"=>array(0=>"抄送人员ID"),"notify_type"=>1,"apply_data"=>array("contents"=>array(0=>array("control"=>"Text","id"=>"Text-1613713873031","value"=>array("text"=>$uname)),1=>array("control"=>"Text","id"=>"Text-1613713907687","value"=>array("text"=>$phone)),2=>array("control"=>"Text","id"=>"Text-1586930029610","value"=>array("text"=>$course)),3=>array("control"=>"Money","id"=>"Money-1586930048663","value"=>array("new_money"=>$fee)),4=>array("control"=>"Text","id"=>"Textarea-1586930035590","value"=>array("text"=>$reason)),5=>array("control"=>"Selector","id"=>"Selector-1613725714279","value"=>array("selector"=>array("type"=>"single","options"=>array(0=>array("key"=>$school)))) ))));httpPost($url,json_encode($arrdate));$data['code'] = 'true';$data['msg'] = '申请成功！'; $data['phone'] = $phone;echo json_encode($data); function test_input($data) {$data = trim($data);$data = stripslashes($data);$data = htmlspecialchars($data);return $data;
}function httpPost($url,$params=false,$ispost=0){$httpInfo = array();$ch = curl_init();curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );curl_setopt( $ch, CURLOPT_USERAGENT , 'Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.22 (KHTML, like Gecko) Chrome/25.0.1364.172 Safari/537.22' );curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 30 );curl_setopt( $ch, CURLOPT_TIMEOUT , 30);curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );if( $ispost ){curl_setopt( $ch , CURLOPT_POST , true );curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );curl_setopt( $ch , CURLOPT_URL , $url );}else{if($params){curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );}else{curl_setopt( $ch , CURLOPT_URL , $url);}}$response = curl_exec( $ch );if ($response === FALSE) {//echo "cURL Error: " . curl_error($ch);return false;}$httpCode = curl_getinfo( $ch , CURLINFO_HTTP_CODE );$httpInfo = array_merge( $httpInfo , curl_getinfo( $ch ) );curl_close( $ch );return $response;
}前端H5代码
<!DOCTYPE html>
<html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no"> <title>退费申请</title><link rel="stylesheet" type="text/css" href="js/jquery.dialogbox.css"/><link rel="stylesheet" type="text/css" href="js/style.css"/></head><body><div class="formtop"><h2>退费申请</h2> <div class="bmcon"><div class="formk"><input type="text" class="forminput" name="uname" id="uname" placeholder="输入报名人姓名" /></div><div class="formk"><input type="text" class="forminput" name="uphone" id="uphone" placeholder="输入报名人手机号" /></div><div class="formk"><select class="forminput" name="school" id="school"><option value="">请选择报名校区</option> <option value="option-1613725808454">人广</option><option value="option-1613725808456">金桥</option><option value="option-1613725808457">上南</option></select></div><div class="formk"><input type="text" class="forminput" name="course" id="course" placeholder="报名课程" /> </div><div class="formk"><input type="text" class="forminput" name="fee" id="fee" placeholder="退费金额" /> </div><div class="formk"><input type="text" class="forminput" name="reason" id="reason" placeholder="退费原因" /> </div><div class="formk"><button type="submit" class="btncheng" id="fmbtn" onClick="return CheckAll();">立即申请</button></div> </div><div id="btn-dialogBox"></div> </div><script src="js/jquery.js" type="text/javascript" charset="utf-8"></script><script src="js/jquery.dialogBox.js" type="text/javascript" charset="utf-8"></script><script type="text/javascript">function mess(info) {$('#btn-dialogBox').dialogBox({width: 300,height: 200,autoHide: true,time: 1500,effect: 'flip-horizontal',//title: 'title text',content: '<img src="js/ifau.png"><br/><br/>' + info});}function mess2(info) {$('#btn-dialogBox').dialogBox({width: 300,height: 200,autoHide: true,time: 1500,effect: 'flip-horizontal',//title: 'title text',content: '<img src="js/isuc.png"><br/><br/>' + info});}function CheckAll() {if($("#uname").val() == "") {mess("用户名不能为空！");$("#uname").focus();return false;}if(!/^[\u4e00-\u9fa5]{2,5}$/.test($("#uname").val())) {mess("姓名必须是中文");$("#uname").focus();return false;}if(!/^1[3|4|5|7|8]\d{9}$/.test($("#uphone").val())) {mess("请填写正确的手机号码"); $("#uphone").focus();return false;}if($("#school option:selected").attr("value") == "") {mess("请选择交费校区！");$("#school").focus();return false;}if(!/(^[1-9]\d*$)/.test($("#fee").val())) {mess("请填写退费金额"); $("#fee").focus();return false;}//AJAX数据提交$.ajax({type:"POST",url:"/weixin/api/examples/ApprovalTest.php",data:{uname:$("#uname").val(),phone:$("#uphone").val(),school:$("#school").val(),course:$("#course").val(),fee:$("#fee").val(),reason:$("#reason").val()},cache:false,dataType:'json', beforeSend:function(){$("#fmbtn").html("数据提交中，请稍后...");},success:function(data) { if(data.code =="true" ){ mess(data.msg); $("input").val("");$("#fmbtn").html("立即提交");} }, error : function() { mess(data.msg); } }); }</script></script></body>
</html>
至此，功能完成。后台审核的机制可以企业微信里面自己设置比较简单可以让企业微信管理员按需求设置。
企业微信开发----H5发送表单请求到企业微信内部审核相关推荐
- JavaScript fetch 方式提交表单请求
最近在研究如何使用 fetch 方法发送表单请求,因为我们一般使用的时候fetch一般会将发送的数据处理成 JSON 字符串的格式进行发送,但是如果提交表单的话由于表单格式需要特殊处理,因为无法直接使 ...
- 企业微信开发H5页面授权 使用接口的问题
企业微信 h5踩坑指南 企业微信开发H5页面授权 使用接口的问题 开发企业微信的时候 h5页面需要获取登录用户的信息,这个时候就需要jsdk里面的 [开发文档] (https://work.weixi ...
- 微信公众平台开发之万能表单
微信公众平台开发之万能表单是为了方便我们得到用户的信息.我们可以在后台设置任何需要用户填写的信息,比如:电话,姓名,性别,工作等等信息,当然我们也可以设置一定的奖励,只要完善这些信息就可以得到一定的礼 ...
- http常见的form表单请求方式
2019独角兽企业重金招聘Python工程师标准>>> 在Web开发中,我们使用的比较多的HTTP请求方式基本上就是GET.POST. 一.http请求常见的表单文件上传形式 ...
- java 提交表单_http常见的form表单请求方式
在Web开发中,我们使用的比较多的HTTP请求方式基本上就是GET.POST. 一.http请求常见的表单文件上传形式 首先了解下application/x-www-form-urlencoded和m ...
- php音频转换接口,PHP实现chrome表单请求数据转换为接口使用的json数据
为什么要写转换程序 最近在做旧版程序迁移,旧的架构为常规的MVC模式,新版架构全部改成restful架构. 由于改版数据是一致的,但是请求结构不一致,新版的请求全部以json形式提交,为了方便测试,之 ...
- ios 优化html表单提交,iOS 使用AFNetworking的form表单请求
首先说明下form表单请求,是一种特殊的post请求,请求方式有application/x-www-form-urlencoded.multipart/form-data.application/js ...
- idea generated-requests.http 表单请求示例
以下是一个使用 "idea generated-requests.http" 发送 HTTP 表单请求的示例: POST https://www.example.com/form ...
- PHP curl模拟表单上传文件 微信公众号素材管理接口crul文件上传核心源码
PHP curl模拟表单上传文件 微信公众号素材管理接口crul文件上传核心源码 /*** curl 上传文件* @param $url* @param $filePath* @param stri ...
- 微信开发h5图片上传（拍照、图片压缩、IOS照片旋转)
微信开发h5图片上传 开发环境 vue.js,原生h5 input file, 微信公众号网页 依赖安装 exif-js:IOS下拍照照片的方向有问题, 需要exif-js来读取照片信息进行旋转处理: ...
最新文章
- Mybatis调用Oracle的存储过程
- PyQt5 技术篇-调用字体对话框(QFontDialog)获取字体，控件设置字体。
- 织女的红线_JAVA
- iOS Hacker Xcode7免登录开发者账号打包ipa
- Use Case 和User Story
- c ++产生不同的随机数_C ++程序生成随机密码
- datetime方法
- Git 代码管理（代码提交和代码回退）
- 数据展示_使用Cadvisor监控容器并展示数据
- 【BZOJ2989】数列（CDQ分治，扫描线）
- C语言程序所以,C语言程序（1）
- Winform DataGridView修改数据源界面不刷新问题
- list 转 json，以及 json 解析
- 计算机光驱启动设置,光驱启动怎么设置
- 【转】Windows批处理学习(一)——MS-DOS命令
- Java Grammar：数据类型
- python怎么保存代码.py_pycharm的基本操作，创建项目，新建py文件，编写代码及保存...
- 计算机表格怎么同时选中分开的两项,excel怎么把三个单元格分成两个
- go-micro教程
- Nature综述：大脑中的音乐