微信接口简介

1、  了解HttpClient

HttpClient 是 Apache Jakarta Common 下的子项目,可以用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包,并且它支持 HTTP 协议最新的版本和建议。

HttpClient有如下特点

(1)实现了所有 HTTP 的方法(GET,POST,PUT,HEAD 等)

(2)支持自动跳转

(3)支持 HTTPS 协议

(4)支持代理服务器等

微信公众号需要用到的就是(1)和(3),所以这里只演示(1)和(3)

 

Get方法

public void get() throws Exception {
    // (1) 创建HttpGet实例
   
HttpGet get = new HttpGet("http://localhost:8080/iheima/getWithNoParam");

    // (2) 使用HttpClient发送get请求,获得返回结果HttpResponse
   
HttpClient http = HttpClients.createDefault();
    HttpResponse response = http.execute(get);

    // (3) 读取返回结果
   
if (response.getStatusLine().getStatusCode() == 200) {
        HttpEntity entity = response.getEntity();

        InputStream in = entity.getContent();
        BufferedReader reader = new BufferedReader(new InputStreamReader(in));
        String line = null;
        while ((line = reader.readLine()) != null) {
            System.out.println(line);
        }
        in.close();
        reader.close();
    }
}

 

 

Get带参数

public void getWithParam() throws URISyntaxException, IOException {
    // (1)创建查询参数

   
URI uri = new URIBuilder()
            .setScheme("http")
            .setHost("127.0.0.1")
            .setPort(8080)
            .setPath("/iheima/getWithParam")
            .setParameter("param", "ice")
            .build();

    // (2) 创建Get实例
   
HttpGet get = new HttpGet(uri);

    // (3) 使用HttpClient发送get请求,获得返回结果HttpResponse
   
HttpClient http = HttpClients.createDefault();
    HttpResponse response = http.execute(get);

    // (4) 读取返回结果
   
if (response.getStatusLine().getStatusCode() == 200) {
        HttpEntity entity = response.getEntity();

        InputStream in = entity.getContent();
        BufferedReader reader = new BufferedReader(new InputStreamReader(in));
        String line = null;
        while ((line = reader.readLine()) != null) {
            System.out.println(line);
        }
        in.close();
        reader.close();
    }
}

 

 

Post方法

public void post() throws Exception {
    // (1) 创建HttpPost实例
   
HttpPost post = new HttpPost("http://localhost:8080/iheima/postWithNoParam");

    // (2) 使用HttpClient发送post请求,获得返回结果HttpResponse
   
HttpClient http = HttpClients.createDefault();
    HttpResponse response = http.execute(post);

    // (3) 读取返回结果
   
if (response.getStatusLine().getStatusCode() == 200) {
        HttpEntity entity = response.getEntity();

        InputStream in = entity.getContent();
        BufferedReader reader = new BufferedReader(new InputStreamReader(in));
        String line = null;
        while ((line = reader.readLine()) != null) {
            System.out.println(line);
        }
        in.close();
        reader.close();
    }
}

 

 

Post带参数

public void postWithParam() throws IOException {
    // (1) Post请求
   
HttpPost post = new HttpPost("http://localhost:8080/iheima/postWithParam");

    //添加参数
   
List<NameValuePair> params = new ArrayList<NameValuePair>();
    params.add(new BasicNameValuePair("param", "post ice"));
    post.setEntity(new UrlEncodedFormEntity(params, HTTP.UTF_8));

    // (3) 发送请求
   
HttpClient http = HttpClients.createDefault();
    HttpResponse response = http.execute(post);

    // (3) 读取返回结果
   
if (response.getStatusLine().getStatusCode() == 200) {
        HttpEntity entity = response.getEntity();

        InputStream in = entity.getContent();
        BufferedReader reader = new BufferedReader(new InputStreamReader(in));
        String line = null;
        while ((line = reader.readLine()) != null) {
            System.out.println(line);
        }
        in.close();
        reader.close();
    }
}

 

 

2、  了解微信接口

微信提供的接口基本上都是以SSL (Secure Sockets Layer 安全套接层)加密请求的。

如获取access_token的接口地址为:

 

以下为参数说明:

参数

是否必须

说明

grant_type

获取access_token填写client_credential

appid

第三方用户唯一凭证

secret

第三方用户唯一凭证密钥,即appsecret

 

正常情况下,微信会返回下述JSON数据包给公众号:

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

对照的参数表为:

参数

说明

access_token

获取到的凭证

expires_in

凭证有效时间,单位:秒

 

以下为使用SSL加密方式用get的方式调用微信接口的方法:

 

public void getSSL() throws Exception {
    // Trust own CA and all self-signed certs
   
SSLContext sslcontext = SSLContexts.custom()
            .loadTrustMaterial(null,
                    new TrustStrategy() {
                        public boolean isTrusted(X509Certificate[] chain, String authType) throws CertificateException {//信任所有
                           
return true;
                        }
                    })
            .build();
    SSLConnectionSocketFactory sslsf = new SSLConnectionSocketFactory(sslcontext);
    CloseableHttpClient httpclient = HttpClients.custom().setSSLSocketFactory(sslsf).build();
    try {
        HttpGet httpget = new HttpGet("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET");
        System.out.println("executing request " + httpget.getRequestLine());
        CloseableHttpResponse response = httpclient.execute(httpget);
        // (3) 读取返回结果
       
if (response.getStatusLine().getStatusCode() == 200) {
            HttpEntity entity = response.getEntity();
            InputStream in = entity.getContent();
            BufferedReader reader = new BufferedReader(new InputStreamReader(in));
            String line = null;
            while ((line = reader.readLine()) != null) {
                System.out.println(line);
            }
            in.close();
            reader.close();
        }
        response.close();
    } finally {
        httpclient.close();
    }
}
 
最后附上maven项目所需要的依赖:
    <dependency>
      <groupId>org.apache.httpcomponents</groupId>
      <artifactId>httpclient</artifactId>
      <version>4.4</version>
</dependency>
 
注:微信各类详细接口明天再讲
 
 
微信接口开发流程:
1、在开发者首次提交验证申请时,微信服务器将发送GET请求到填写的URL上,并且带上四个参数(signature、timestamp、nonce、echostr),开发者通过对签名(即signature)的效验,来判断此条消息的真实性。

参数

描述

signature

微信加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。

timestamp

时间戳

nonce

随机数

echostr

随机字符串

加密/校验流程如下:
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于微信
第一次处理来自于微信和校验时,只需要要把echostr返回给来自于微信的请求即校验通过
 
 全局access_token:其他微信接口,需要通过基础支持中的“获取access_token”接口来获取到的普通access_token调用。
 
 授权access_token:通过OAuth2.0机制实现的,在用户授权给公众号后,公众号可以获取网页授权access_token,通过网页授权access_token可以进行授权后接口调用,如获取用户基本信息;
 
 用户open_id
用户唯一标识,请注意,在未关注公众号时,用户访问公众号的网页,也会产生一个用户和公众号唯一的OpenID,相对于一个公众号来说,openid是唯一的
 
 用户union_id:
1、请注意,网页授权获取用户基本信息也遵循UnionID机制。即如果开发者有在多个公众号,或在公众号、移动应用之间统一用户帐号的需求,需要前往微信开放平台(open.weixin.qq.com)绑定公众号后,才可利用UnionID机制来满足上述需求。
2、UnionID机制的作用说明:如果开发者拥有多个移动应用、网站应用和公众帐号,可通过获取用户基本信息中的unionid来区分用户的唯一性,因为同一用户,对同一个微信开放平台下的不同应用(移动应用、网站应用和公众帐号),unionid是相同的。
 
微信接口列表
1.    获取access_token
2.    接收消息
  Ø  验证消息真实性:使用我们上面介绍的方法进行验证
  Ø  接收消息,
  Ø  接收事件:关注、取关、扫描二维码()、定位、点击自定义菜单(分为两类:获取信息和跳转)
3.    发送消息
  Ø  自动回复
  Ø  客服(没研究)
  Ø  群发
  Ø  回复模板(一定格式的微信消息)
4.    素材管理
5.    用户管理
  Ø  设置备注名
  Ø  获取用户列表(分页获取,每页10000个,获取的是OpenID)
  Ø  获取用户信息(两种方式:UinionID和OpneID)
  Ø  授权登录(即授权获取用户信息)
6.    自定义菜单
  Ø  自定义的菜单有两种类型:
    n   点击后以消息方式返回结果;click
    n   以链接形式形成跳转.view
  Ø  增删查
  Ø  有关事件
7.    获取统计信息
8.    JS-SDK(可以用微信扫下,体验下接口类型,不列举了╮(╯▽╰)╭)

  To do 是否可以转发到朋友圈
9.    微信小店接口
10.  多客服接口
11.  微信支付
  Ø  刷卡支付
  Ø  公众号支付
  Ø  扫码支付
  Ø  App支付
  Ø  代金券或立减支付
  Ø  现金红包
  Ø  企业付款
 
 
参考资料
微信公众号文档:
http://mp.weixin.qq.com/wiki/home/index.html
 
微信开放平台文档:
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&lang=zh_CN
 
微信支付文档:
http://pay.weixin.qq.com/wiki/doc/api/index.html
 
测试帐号地址:
http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
 
支付开发教程(微信商户平台版):
https://mp.weixin.qq.com/paymch/readtemplate?t=mp/business/course3_tmpl&lang=zh_CN
 
方倍工作室:
http://www.cnblogs.com/txw1958/
 
封装好的微信框架:
https://github.com/liyiorg/weixin-popular
https://github.com/chanjarster/weixin-java-tools
 
httpcomponents 文档:https://hc.apache.org/httpcomponents-client-4.4.x/tutorial/html/index.html
 
作业,使用把前面的httpclient的例子跑起来

微信接口简介

上一篇:微信开发之如何成为开发者


下一篇:Android 分享到微信信息