me.chanjar.weixin.mp.api.WxMpQrcodeService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of weixin-java-mp Show documentation

微信公众号Java SDK

There is a newer version: 4.6.9.B

package me.chanjar.weixin.mp.api;

import me.chanjar.weixin.common.exception.WxErrorException;
import me.chanjar.weixin.mp.bean.result.WxMpQrCodeTicket;

import java.io.File;

/**
 * 二维码相关操作接口
 *
 * @author Binary Wang
 */
public interface WxMpQrcodeService {

  /**
   *    * 换取临时二维码ticket
   * 详情请见: 生成带参数的二维码
   * 
   *
   * @param scene_id       参数。
   * @param expire_seconds 过期秒数，默认60秒，最小60秒，最大1800秒
   */
  WxMpQrCodeTicket qrCodeCreateTmpTicket(int scene_id, Integer expire_seconds) throws WxErrorException;

  /**
   *    * 换取永久二维码ticket
   * 详情请见: 生成带参数的二维码
   * 
   *
   * @param scene_id 参数。永久二维码时最大值为100000（目前参数只支持1--100000）
   */
  WxMpQrCodeTicket qrCodeCreateLastTicket(int scene_id) throws WxErrorException;

  /**
   *    * 换取永久字符串二维码ticket
   * 详情请见: 生成带参数的二维码
   * 
   *
   * @param scene_str 参数。字符串类型长度现在为1到64
   */
  WxMpQrCodeTicket qrCodeCreateLastTicket(String scene_str) throws WxErrorException;

  /**
   *    * 换取二维码图片文件，jpg格式
   * 详情请见: 生成带参数的二维码
   * 
   *
   * @param ticket 二维码ticket
   */
  File qrCodePicture(WxMpQrCodeTicket ticket) throws WxErrorException;

  /**
   *    * 换取二维码图片url地址（可以选择是否生成压缩的网址）
   * 详情请见: 生成带参数的二维码
   * 
   *
   * @param ticket       二维码ticket
   * @param needShortUrl 是否需要压缩的二维码地址
   */
  String qrCodePictureUrl(String ticket, boolean needShortUrl) throws WxErrorException;

  /**
   *    * 换取二维码图片url地址
   * 详情请见: 生成带参数的二维码
   * 
   *
   * @param ticket 二维码ticket
   */
  String qrCodePictureUrl(String ticket) throws WxErrorException;

}