微信企业号开发

  

调用企业微信接口首先要有以下条件

1、有一个企业微信账户

2、请求api时需要带上AccessToken

3、组装企业微信规定的报文格式

 

第一，创建一个全新的企业账户

在企业微信中点击全新创建企业

补充完信息后点击创建

 

第一，获取token

登录企业微信网页版继续后面操作：https://work.weixin.qq.com/login

AccessToken是企业号的全局唯一票据，调用接口时需携带AccessToken。

AccessToken需要用CorpID和Secret来换取，不同的Secret会返回不同的AccessToken。正常情况下AccessToken有效期为7200秒，有效期内重复获取返回相同结果。access_token至少保留512字节的存储空间。

 corpid获取

在企业网页版找到“我的企业”，“企业信息”，下面的企业ID就是corpid

 

 

获取 corpsecret

在“应用管理”，“应用”，如图箭头指示的位置，新建一个应用

 

创建完成之后会看到Secret，点击查看，根据提示操作即可获取 corpsecret

 

有了corpid和corpsecret就可以获取token了

• 请求说明

　　　Https请求方式: GET

           https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect

• 参数说明 

参数	必须	说明
corpid	是	企业Id
corpsecret	是	管理组的凭证密钥

 

 

 

 

 

        权限说明

　　　　每个secret代表了对应用、通讯录的不同权限；不同的管理组拥有不同的secret。

• 返回说明

　　　　a)正确的Json返回结果:

　　　　{
   　　　　"access_token": "accesstoken000001",
   　　　　"expires_in": 7200
　　　　}

参数	说明
access_token	获取到的凭证。长度为64至512个字节
expires_in	凭证的有效时间（秒）

 

 

 

 

　　　　

　　b)错误的Json返回示例:

　　　　{
   　　　　"errcode": 43003,
   　　　　"errmsg": "require https"
　　　　}

获取到token之后接下来就是组装请求报文

下面是官网给出的请求报文格式

{
   "touser": "UserID1|UserID2|UserID3",
   "toparty": " PartyID1 | PartyID2 ",
   "totag": " TagID1 | TagID2 ",
   "msgtype": "text",
   "agentid": 1,
   "text": {
       "content": "Holiday Request For Pony(http://xxxxx)"
   },
   "safe":0
}

备注：touser就是选择要发送的对象，如果管理员没有特别设置，一般就是用户的名字，如果是想全员分发，可以设置为 @all 即可，下面是我组装的一个测试报文

{
   "touser" : "@all",
   "msgtype" : "text",
   "agentid" : 1000002,
   "text" : {
       "content" : "我就试一下"
   },
   "safe":0
}

下面就是具体实现的代码

package com.spring.earlywarning.util;

import net.sf.json.JSONObject;

import javax.net.ssl.HttpsURLConnection;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.io.PrintStream;
import java.net.HttpURLConnection;
import java.net.URL;

/**
 * @author liuwenlong
 * @create 2022-03-16 00:47:16
 */
@SuppressWarnings("all")
public class MyWeixin {

    public MyWeixin() {
    }

    //接收消息接口
    public void sendMessageToWinxin(String message) throws Exception {
        message = message.trim();
        message = message.replace("\r\n", ",");
        message = message.replace("\n", ",");
        String Json = "{\n" +
                "   \"touser\" : \"@all\",\n" +
                "   \"msgtype\" : \"text\",\n" +
                "   \"agentid\" : 1000002,\n" +
                "   \"text\" : {\n" +
                "       \"content\" : \" " + message + "\"\n" +
                "   },\n" +
                "   \"safe\":0\n" +
                "}";

        String getTokenUrl = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=你的corpid&corpsecret=你的corpsecret";
        String token = getToken(getTokenUrl);
        String urlPath = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=" + token;
        doJsonPost(urlPath, Json);
    }

    //获取token
    public String getToken(String URL) {
        try {
            java.net.URL u = new URL(URL);
            HttpsURLConnection huconn = (HttpsURLConnection) u.openConnection();
            BufferedReader in = null;
            StringBuilder result = new StringBuilder();
            huconn.connect();
            in = new BufferedReader(new InputStreamReader(huconn.getInputStream(), "UTF-8"));
            String line;
            while ((line = in.readLine()) != null) {
                result.append(line);
            }
            if (in != null) {
                in.close();
            }
            huconn.disconnect();

            JSONObject myJsonObject = new JSONObject();
            myJsonObject = JSONObject.fromObject(result.toString());
            String token = myJsonObject.getString("access_token");
            return token;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return "";
    }

    //发送信息
    public void doJsonPost(String urlPath, String Json) throws Exception {
        String result = "";
        BufferedReader reader = null;
        URL url = new URL(urlPath);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setDoOutput(true);
        conn.setDoInput(true);
        conn.setUseCaches(false);
        conn.setRequestProperty("Encoding", "UTF-8");
        conn.setRequestProperty("Connection", "Keep-Alive");
        conn.setRequestProperty("Charset", "application/json;UTF-8");

        byte[] writebytes = Json.getBytes();
        // 设置文件长度
        conn.setRequestProperty("Content-Length", String.valueOf(writebytes.length));
        OutputStreamWriter outwritestream = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");
        outwritestream.write(Json.toCharArray());
        outwritestream.flush();

        System.out.println(conn.getResponseCode());
        if (conn.getResponseCode() == 0) {
            System.out.println(Json);
        }
    }

}

运行起来测试一下？

然后可以绑定微信账户，在微信接收消息即可