快捷導(dǎo)航

微信小程序?qū)崿F(xiàn)獲取小程序碼和二維碼java接口開(kāi)發(fā)

更新時(shí)間：2019年03月29日 14:20:50 作者：天才小小布

這篇文章主要介紹了微信小程序?qū)崿F(xiàn)獲取小程序碼和二維碼java接口開(kāi)發(fā),小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

前言：目前小程序推出了自己的識(shí)別碼，小程序碼，這個(gè)圓形的碼看起來(lái)比二維碼好看。本文總結(jié)微信小程序的獲取小程序碼和二維碼并生成二維碼圖片的接口開(kāi)發(fā)。主要內(nèi)容摘抄自微信小程序的API文檔，java接口開(kāi)發(fā)是自己總結(jié)開(kāi)發(fā)。

微信小程序API文檔：獲取二維碼

一、簡(jiǎn)介

通過(guò)后臺(tái)接口可以獲取小程序任意頁(yè)面的二維碼，掃描該二維碼可以直接進(jìn)入小程序?qū)?yīng)的頁(yè)面。目前微信支持兩種二維碼，小程序碼（左），小程序二維碼（右），如下所示：

二、獲取小程序碼

目前有兩個(gè)接口可以生成小程序碼，開(kāi)發(fā)者可以根據(jù)自己的需要選擇合適的接口。

1 不帶參數(shù)有限個(gè)數(shù)小程序碼接口

適用于需要的碼數(shù)量較少的業(yè)務(wù)場(chǎng)景

接口地址：https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN

注：獲取accesstoken的方法跟微信公眾獲取accesstoken方法一致，不過(guò)小程序獲取accesstoken需要小程序的appid和appsercet。登錄 https://mp.weixin.qq.com ，就可以在網(wǎng)站的“設(shè)置”-“開(kāi)發(fā)者設(shè)置”中，查看到微信小程序的 AppID 了，注意不可直接使用服務(wù)號(hào)或訂閱號(hào)的 AppID 。

獲取微信小程序的 AppID文章地址：小程序簡(jiǎn)易教程

（1）POST 參數(shù)說(shuō)明

參數(shù)	類(lèi)型	默認(rèn)值	說(shuō)明
path	String		不能為空，最大長(zhǎng)度 128 字節(jié)
width	Int	430	二維碼的寬度
auto_color	Bool	false	自動(dòng)配置線(xiàn)條顏色，如果顏色依然是黑色，則說(shuō)明不建議配置主色調(diào)
line_color	Object	{“r”:”0”,”g”:”0”,”b”:”0”}	auth_color 為 false 時(shí)生效，使用 rgb 設(shè)置顏色例如 {“r”:”xxx”,”g”:”xxx”,”b”:”xxx”}

注意：通過(guò)該接口生成的小程序碼，永久有效，但數(shù)量有效，請(qǐng)謹(jǐn)慎使用。用戶(hù)掃描該碼進(jìn)入小程序后，將直接進(jìn)入 path 對(duì)應(yīng)的頁(yè)面。

（2）請(qǐng)求接口測(cè)試

使用http請(qǐng)求插件postman或者RESTClient請(qǐng)求測(cè)試。

請(qǐng)求測(cè)試結(jié)果返回一個(gè)小程序碼圖片，與微信公眾平臺(tái)生成二維碼不同，小程序碼直接返回文件流，不是微信公眾平臺(tái)的url和ticket。

（3）java接口開(kāi)發(fā)

注：此接口是基于Spring RestTemplate進(jìn)行http請(qǐng)求，進(jìn)行http請(qǐng)求有很多方法和工具類(lèi)，可自行百度或參考下面的參考文章。接口只是提供一個(gè)解決方法的思路。

 public Map getminiqrQr(String accessToken) {
  RestTemplate rest = new RestTemplate();
  InputStream inputStream = null;
  OutputStream outputStream = null;
  try {
   String url = "https://api.weixin.qq.com/wxa/getwxacode?access_token="+accessToken;
   Map<String,Object> param = new HashMap<>();
   param.put("page", "pages/index/index");
   param.put("width", 430);
   param.put("auto_color", false);
   Map<String,Object> line_color = new HashMap<>();
   line_color.put("r", 0);
   line_color.put("g", 0);
   line_color.put("b", 0);
   param.put("line_color", line_color);
   LOG.info("調(diào)用生成微信URL接口傳參:" + param);
   MultiValueMap<String, String> headers = new LinkedMultiValueMap<>();
   HttpEntity requestEntity = new HttpEntity(param, headers);
   ResponseEntity<byte[]> entity = rest.exchange(url, HttpMethod.POST, requestEntity, byte[].class, new Object[0]);
   LOG.info("調(diào)用小程序生成微信永久小程序碼URL接口返回結(jié)果:" + entity.getBody());
   byte[] result = entity.getBody();
   LOG.info(Base64.encodeBase64String(result));
   inputStream = new ByteArrayInputStream(result);

   File file = new File("C:/Users/wangqiulin/Desktop/1.png");
   if (!file.exists()){
    file.createNewFile();
   }
   outputStream = new FileOutputStream(file);
   int len = 0;
   byte[] buf = new byte[1024];
   while ((len = inputStream.read(buf, 0, 1024)) != -1) {
    outputStream.write(buf, 0, len);
   }
   outputStream.flush();
  } catch (Exception e) {
   LOG.error("調(diào)用小程序生成微信永久小程序碼URL接口異常",e);
  } finally {
   if(inputStream != null){
    try {
     inputStream.close();
    } catch (IOException e) {
     e.printStackTrace();
    }
   }
   if(outputStream != null){
    try {
     outputStream.close();
    } catch (IOException e) {
     e.printStackTrace();
    }
   }
  }
  return null; 
 }

說(shuō)明：accessToken的獲取方法就不多說(shuō)，因?yàn)樾〕绦蚨S碼很坑爹的返回文件流，導(dǎo)致我們必須對(duì)流進(jìn)行處理轉(zhuǎn)換成圖片保存到本地，這樣還有一個(gè)嚴(yán)重的后果就是無(wú)法將二維碼保存到數(shù)據(jù)庫(kù)中，每次想獲取二維碼必須請(qǐng)求接口，此接口最多生成不超過(guò)100000個(gè)，請(qǐng)大家謹(jǐn)慎使用。

2 帶參數(shù)無(wú)限個(gè)數(shù)小程序碼接口

適用于需要的碼數(shù)量極多，或僅臨時(shí)使用的業(yè)務(wù)場(chǎng)景

接口地址：https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN

獲取accessToken的方法跟接口1一致。

（1）POST 參數(shù)說(shuō)明

參數(shù)	類(lèi)型	默認(rèn)值	說(shuō)明
scene	String		最大32個(gè)可見(jiàn)字符，只支持?jǐn)?shù)字，大小寫(xiě)英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~，其它字符請(qǐng)自行編碼為合法字符（因不支持%，中文無(wú)法使用 urlencode 處理，請(qǐng)使用其他編碼方式）
page	String		必須是已經(jīng)發(fā)布的小程序頁(yè)面，例如 “pages/index/index” ,如果不填寫(xiě)這個(gè)字段，默認(rèn)跳主頁(yè)面
width	Int	430	二維碼的寬度
auto_color	Bool	false	自動(dòng)配置線(xiàn)條顏色，如果顏色依然是黑色，則說(shuō)明不建議配置主色調(diào)
line_color	Object	{“r”:”0”,”g”:”0”,”b”:”0”}	auto_color 為 false 時(shí)生效，使用 rgb 設(shè)置顏色例如 {“r”:”xxx”,”g”:”xxx”,”b”:”xxx”}

注意：通過(guò)該接口生成的小程序碼，永久有效，數(shù)量暫無(wú)限制。用戶(hù)掃描該碼進(jìn)入小程序后，開(kāi)發(fā)者需在對(duì)應(yīng)頁(yè)面獲取的碼中 scene 字段的值，再做處理邏輯。使用如下代碼可以獲取到二維碼中的 scene 字段的值。調(diào)試階段可以使用開(kāi)發(fā)工具的條件編譯自定義參數(shù) scene=xxxx 進(jìn)行模擬，開(kāi)發(fā)工具模擬時(shí)的 scene 的參數(shù)值需要進(jìn)行 urlencode。同時(shí)需要注意，此接口的page參數(shù)中不能帶任何參數(shù)，參數(shù)都在scene 參數(shù)中處理，切記！?。?/p>

// 這是首頁(yè)的 js
Page({
 onLoad: function(options) {
 // options 中的 scene 需要使用 decodeURIComponent 才能獲取到生成二維碼時(shí)傳入的 scene
 var scene = decodeURIComponent(options.scene)
 }
})

（2）請(qǐng)求接口測(cè)試

（3）java接口開(kāi)發(fā)

 public Map getminiqrQr(String sceneStr, String accessToken) {
  RestTemplate rest = new RestTemplate();
  InputStream inputStream = null;
  OutputStream outputStream = null;
  try {
   String url = "https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token="+accessToken;
   Map<String,Object> param = new HashMap<>();
   param.put("scene", sceneStr);
   param.put("page", "pages/index/index");
   param.put("width", 430);
   param.put("auto_color", false);
   Map<String,Object> line_color = new HashMap<>();
   line_color.put("r", 0);
   line_color.put("g", 0);
   line_color.put("b", 0);
   param.put("line_color", line_color);
   LOG.info("調(diào)用生成微信URL接口傳參:" + param);
   MultiValueMap<String, String> headers = new LinkedMultiValueMap<>();
   HttpEntity requestEntity = new HttpEntity(param, headers);
   ResponseEntity<byte[]> entity = rest.exchange(url, HttpMethod.POST, requestEntity, byte[].class, new Object[0]);
   LOG.info("調(diào)用小程序生成微信永久小程序碼URL接口返回結(jié)果:" + entity.getBody());
   byte[] result = entity.getBody();
   LOG.info(Base64.encodeBase64String(result));
   inputStream = new ByteArrayInputStream(result);

   File file = new File("C:/Users/wangqiulin/Desktop/1.png");
   if (!file.exists()){
    file.createNewFile();
   }
   outputStream = new FileOutputStream(file);
   int len = 0;
   byte[] buf = new byte[1024];
   while ((len = inputStream.read(buf, 0, 1024)) != -1) {
    outputStream.write(buf, 0, len);
   }
   outputStream.flush();
  } catch (Exception e) {
   LOG.error("調(diào)用小程序生成微信永久小程序碼URL接口異常",e);
  } finally {
   if(inputStream != null){
    try {
     inputStream.close();
    } catch (IOException e) {
     e.printStackTrace();
    }
   }
   if(outputStream != null){
    try {
     outputStream.close();
    } catch (IOException e) {
     e.printStackTrace();
    }
   }
  }
  return null; 
 }

3 獲取小程序二維碼

適用于需要的碼數(shù)量較少的業(yè)務(wù)場(chǎng)景

接口地址：https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN

（1）POST 參數(shù)說(shuō)明

參數(shù)	類(lèi)型	默認(rèn)值	說(shuō)明
path	String		不能為空，最大長(zhǎng)度 128 字節(jié)
width	Int	430	二維碼的寬度

注意：通過(guò)該接口生成的小程序二維碼，永久有效，數(shù)量限制見(jiàn)文末說(shuō)明，請(qǐng)謹(jǐn)慎使用。用戶(hù)掃描該碼進(jìn)入小程序后，將直接進(jìn)入 path 對(duì)應(yīng)的頁(yè)面。

示例：

{"path": "pages/index?query=1", "width": 430}

注：pages/index 需要在 app.json 的 pages 中定義

（2）請(qǐng)求接口測(cè)試

（3）java接口開(kāi)發(fā)

 public Map getminiqrQr(String accessToken) {
  RestTemplate rest = new RestTemplate();
  InputStream inputStream = null;
  OutputStream outputStream = null;
  try {
   String url = "https://api.weixin.qq.com/wxaapp/createwxaqrcode?access_token="+accessToken;
   Map<String,Object> param = new HashMap<>();
   param.put("page", "pages/index/index");
   param.put("width", 430);
   LOG.info("調(diào)用生成微信URL接口傳參:" + param);
   MultiValueMap<String, String> headers = new LinkedMultiValueMap<>();
   HttpEntity requestEntity = new HttpEntity(param, headers);
   ResponseEntity<byte[]> entity = rest.exchange(url, HttpMethod.POST, requestEntity, byte[].class, new Object[0]);
   LOG.info("調(diào)用小程序生成微信永久二維碼URL接口返回結(jié)果:" + entity.getBody());
   byte[] result = entity.getBody();
   LOG.info(Base64.encodeBase64String(result));
   inputStream = new ByteArrayInputStream(result);

   File file = new File("C:/Users/wangqiulin/Desktop/1.png");
   if (!file.exists()){
    file.createNewFile();
   }
   outputStream = new FileOutputStream(file);
   int len = 0;
   byte[] buf = new byte[1024];
   while ((len = inputStream.read(buf, 0, 1024)) != -1) {
    outputStream.write(buf, 0, len);
   }
   outputStream.flush();
  } catch (Exception e) {
   LOG.error("調(diào)用小程序生成微信永久二維碼URL接口異常",e);
  } finally {
   if(inputStream != null){
    try {
     inputStream.close();
    } catch (IOException e) {
     e.printStackTrace();
    }
   }
   if(outputStream != null){
    try {
     outputStream.close();
    } catch (IOException e) {
     e.printStackTrace();
    }
   }
  }
  return null; 
 }

三、說(shuō)明

1：通過(guò)該接口，僅能生成已發(fā)布的小程序的二維碼。
2：可以在開(kāi)發(fā)者工具預(yù)覽時(shí)生成開(kāi)發(fā)版的帶參二維碼。
3：接口1加上接口2，總共生成的碼數(shù)量限制為100,000，請(qǐng)謹(jǐn)慎調(diào)用。
4 : POST 參數(shù)需要轉(zhuǎn)成 json 字符串，不支持 form 表單提交。
5 : auto_color line_color 參數(shù)僅對(duì)小程序碼生效。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: