C#后端接口返回小程序二维码

在C#后端接口中返回小程序二维码，通常需要调用微信官方的"获取小程序码"接口，然后将生成的二维码图片流返回给前端。以下是实现步骤和代码示例：

一、准备工作

获取小程序Access Token

调用微信接口需要先获取access_token（有效期2小时），接口地址：
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

（APPID和APPSECRET在微信公众平台获取）
调用微信生成二维码接口

推荐使用"获取不限制的小程序码"接口（适用于需要大量生成二维码的场景）：
https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN

二、后端接口实现（ASP.NET Core为例）

1. 工具类：获取Access Token

csharp 复制代码

publicclassWeChatHelper
{
privatereadonlystring _appId;
privatereadonlystring _appSecret;

publicWeChatHelper(string appId, string appSecret)
{
        _appId = appId;
        _appSecret = appSecret;
    }

///<summary>
/// 获取Access Token
///</summary>
publicasync Task<string> GetAccessTokenAsync()
{
usingvar httpClient = new HttpClient();
var url = $"https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={_appId}&secret={_appSecret}";
var response = await httpClient.GetAsync(url);
        response.EnsureSuccessStatusCode();

var result = await response.Content.ReadAsStringAsync();
var json = JObject.Parse(result);
if (json.ContainsKey("errcode"))
        {
thrownew Exception($"获取Access Token失败：{json["errmsg"]}");
        }
return json["access_token"].ToString();
    }
}

2. 接口：生成并返回二维码

csharp 复制代码

[ApiController]
[Route("api/[controller]")]
publicclassQrCodeController : ControllerBase
{
privatereadonly WeChatHelper _weChatHelper;

// 从配置文件注入APPID和APPSECRET（建议通过配置文件管理）
publicQrCodeController(IConfiguration configuration)
{
var appId = configuration["WeChat:AppId"];
var appSecret = configuration["WeChat:AppSecret"];
        _weChatHelper = new WeChatHelper(appId, appSecret);
    }

///<summary>
/// 生成小程序二维码
///</summary>
///<param name="scene">场景值（如：userId=123）</param>
///<param name="page">小程序页面路径（如：pages/index/index）</param>
    [HttpGet("wxacode")]
publicasync Task<IActionResult> GetWxaCode(string scene, string page = "pages/index/index")
{
try
        {
// 1. 获取Access Token
var accessToken = await _weChatHelper.GetAccessTokenAsync();

// 2. 调用微信生成二维码接口
usingvar httpClient = new HttpClient();
var url = $"https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token={accessToken}";

// 构建请求参数（详细参数见微信文档）
var requestData = new
            {
                scene = scene,       // 场景值，必填
                page = page,         // 页面路径，可选（默认首页）
                width = 430,         // 二维码宽度，可选（默认430）
                auto_color = false,  // 是否自动配置线条颜色
                line_color = new { r = 0, g = 0, b = 0 }, // 线条颜色（auto_color为false时生效）
                is_hyaline = false// 是否透明底色
            };

var jsonData = JsonConvert.SerializeObject(requestData);
var content = new StringContent(jsonData, Encoding.UTF8, "application/json");
var response = await httpClient.PostAsync(url, content);

// 3. 处理返回结果（微信接口成功返回图片流，失败返回JSON）
if (response.Content.Headers.ContentType.MediaType == "image/jpeg")
            {
// 成功：返回图片流
var stream = await response.Content.ReadAsStreamAsync();
return File(stream, "image/jpeg");
            }
else
            {
// 失败：解析错误信息
var error = await response.Content.ReadAsStringAsync();
return BadRequest(new { message = "生成二维码失败", detail = error });
            }
        }
catch (Exception ex)
        {
return StatusCode(500, new { message = ex.Message });
        }
    }
}

三、配置文件（appsettings.json）

json 复制代码

{
"WeChat": {
"AppId": "你的小程序APPID",
"AppSecret": "你的小程序APPSECRET"
  }
}

四、前端调用（小程序示例）

kotlin 复制代码

// 调用后端接口获取二维码
wx.request({
url: 'https://你的域名/api/QrCode/wxacode',
data: {
scene: 'userId=123', // 场景值
    page: 'pages/detail/detail'// 跳转页面
  },
responseType: 'arraybuffer', // 关键：指定返回二进制流
  success: (res) => {
// 将二进制流转为图片URL
const imageUrl = 'data:image/jpeg;base64,' + wx.arrayBufferToBase64(res.data);
// 在页面中显示
this.setData({ qrCodeUrl: imageUrl });
  }
});

五、注意事项

Access Token缓存

：access_token有效期2小时，建议缓存（如用Redis）避免频繁调用接口。
场景值限制

：scene参数长度不能超过32个字符，可用于传递业务标识（如用户ID）。
页面路径权限

：page参数指定的页面必须在小程序"已配置的页面路径"中，否则二维码无法跳转。
接口频率限制

：微信接口有调用频率限制，大量生成时需注意控制频率。

更多参数细节可参考微信官方文档：developers.weixin.qq.com/miniprogram...

本文使用文章同步助手同步