获取小程序 scheme 码,拉起小程序

本文介绍了一种通过Java程序实现获取微信小程序Scheme码的方法,适用于短信、邮件等多种场景下的小程序唤起需求。文中提供了完整的代码示例,包括获取微信access_token及生成Scheme链接的过程。

获取小程序 scheme 码,适用于短信、邮件、外部网页、微信内等拉起小程序的业务场景。


import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpUtil;
import com.alibaba.fastjson15.JSONObject;
import com.http.HttpClient;

import java.io.IOException;
import java.net.URLDecoder;
import java.util.HashMap;
import java.util.Map;

public class demo {

    public static String encoding = "UTF-8";
    //微信APPID
    private static String weiXinAppId="";
    //微信秘钥
    private static String weiXinSecret="";

    private static String getAccessToken(){
        String url = "https://api.weixin.qq.com/cgi-bin/token";
        Map<String, String> reqMap = new HashMap<String, String>();
        reqMap.put("grant_type","client_credential");
        reqMap.put("appid",weiXinAppId);
        reqMap.put("secret",weiXinSecret);
        String result="";
        try {
            result = HttpClient.doGet(url,reqMap);
            result = URLDecoder.decode(result, encoding);
        } catch (IOException e) {
            e.printStackTrace();
        }
        JSONObject jsonObject = JSONObject.parseObject(result);
        System.out.print("微信获取accessToken回调报文"+jsonObject);
        return jsonObject.getString("access_token");
    }

    private static String getOpenLink(String redirectUrl){
        String token = getAccessToken();
        String url = "https://api.weixin.qq.com/wxa/generatescheme?access_token="+token;
        JSONObject jumpWxa = new JSONObject();
        jumpWxa.put("path","");
        jumpWxa.put("query","action=epPay&payUrl="+redirectUrl);

        JSONObject reqMap = new JSONObject();
        reqMap.put("jump_wxa",jumpWxa);
        String result="";
        try {
            HttpRequest request = HttpUtil.createPost(url);
            request.contentType("application/json");
            request.body(reqMap.toJSONString());
            result = request.execute().body();
            result = URLDecoder.decode(result, encoding);
            System.out.print("微信获取getOpenLink回调报文"+result);
        } catch (IOException e) {
            e.printStackTrace();
        }
        return result;
    }
}

注意事项(getOpenLike中的redirectUrl参数是在小程序内设置,参考下图)
在这里插入图片描述
在小程序页面路径中填入需要跳转过来页面的路径

在这里插入图片描述

### 3.1 明文 Scheme 拉起小程序的实现方式 明文 Scheme 是一种通过构造特定格式的 URL,实现从外部环境(如 H5 页面或 App)直接跳转至微信小程序的方法。其基本格式如下: ``` weixin://dl/business/?appid=YOUR_APPID&path=pages/index/index&query=YOUR_QUERY&env_version=release ``` 其中,`appid` 为小程序的唯一标识,`path` 表示跳转的目标页面路径,`query` 为跳转时携带的参数信息,`env_version` 用于指定小程序的版本(如正式版、体验版或开发版)。 在实现过程中,开发者可以通过 JavaScript 或 HTML 中的 `<a>` 标签触发跳转,例如: ```javascript location.href = 'weixin://dl/business/?appid=wx1234123123&path=pages/index/index&query=contractCode%3DA20220802002&env_version=release'; ``` 或 ```html <a href="weixin://dl/business/?appid=wx1234123123&path=pages/index/index">点击跳转</a> ``` 该方法无需调用复杂的平台接口,操作简便,适用于需要快速跳转的场景[^3]。 --- ### 3.2 注意事项与安全建议 在使用明文 Scheme 时,需注意以下几点: - **路径配置**:`path` 必须是小程序中已发布的页面路径,且不能包含 query 参数。此外,该路径需在小程序后台【隐私与安全-明文 URL】中进行配置,否则跳转将失败[^4]。 - **参数编**:`query` 参数需经过 URL处理,以避免特殊字符导致解析失败。支持的字符包括数字、大小写英文及部分特殊符号(如 `!#$&'()*+,/:;=?@-._~%`)。 - **长期有效性**:明文 Scheme 链接是长期有效的,但前提是小程序未被下架或路径未被更改。 - **安全机制**:为防止恶意调用,建议在小程序后台开启「明文 Scheme 校验」功能,以增强安全性[^2]。 - **场景值识别**:通过明文 Scheme 打开的小程序,其场景值为 `1286`,开发者可通过该值识别跳转来源[^3]。 --- ### 3.3 问题排查建议 若在使用过程中遇到跳转失败的情况,可参考以下排查步骤: - 确认小程序后台是否已开启「明文 Scheme 拉起小程序」功能[^1]。 - 检查 `path` 是否已在后台配置,且格式正确。 - 确保 `appid` 正确无误,且对应小程序已发布。 - 验证 `query` 参数是否正确编,且未超出 512 字符限制。 - 若在微信外部打开小程序,确认是否指定了 `env_version` 参数。 --- ###
评论 10
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值