带参数的微信小程序码服务端(golang)生成

#带参数的微信小程序码服务端(golang)生成 | 来源: 网络整理| 查看: 265

官方接口

微信小程序码共有3个接口可以生成：

获取小程序码 POST https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN 该接口用于获取小程序码，适用于需要的码数量较少的业务场景。通过该接口生成的小程序码，永久有效，有数量限制

path参数指定扫码进入的页面，最大长度 1024 字节，不能为空可以带参数page/example?foo=bar

获取不限制的小程序码 POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN 该接口用于获取小程序码，适用于需要的码数量极多的业务场景。通过该接口生成的小程序码，永久有效，数量暂无限制

page参数指定扫码进入的页面，非必要参数，不可以带参数page/example

获取小程序二维码 POST https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN 获取小程序二维码，适用于需要的码数量较少的业务场景。通过该接口生成的小程序码，永久有效，有数量限制

path参数指定扫码进入的页面，最大长度 128 字节，不能为空，可以带参数page/example?foo=bar

以上3个接口之间的差异主要在于参数以及可以生成的数量，接口1和3整体差异比较少（path参数长度不同；小程序码和小程序二维码）,接口2生成数量不受限制，但是指定打开的页面的参数page不能带参数（可以考虑通过scene参数传递，我目前还没验证）

具体的差异和参数可以通过链接查看官方文档

Golang实现

我根据自己的需要，选择了接口1的形式来实现，其他的接口只是接口url和参数的差异，整体流程和调用方式都是一样的。

获取ACCESS_TOKEN123456789101112131415161718192021222324252627282930313233343536func requestToken(appid, secret string) (string, error) { u, err := url.Parse("https://api.weixin.qq.com/cgi-bin/token") if err != nil { log.Fatal(err) } paras := &url.Values{} //设置请求参数 paras.Set("appid", appid) paras.Set("secret", secret) paras.Set("grant_type", "client_credential") u.RawQuery = paras.Encode() resp, err := http.Get(u.String()) //关闭资源 if resp != nil && resp.Body != nil { defer resp.Body.Close() } if err != nil { return "", errors.New("request token err :" + err.Error()) } jMap := make(map[string]interface{}) err = json.NewDecoder(resp.Body).Decode(&jMap) if err != nil { return "", errors.New("request token response json parse err :" + err.Error()) } if jMap["errcode"] == nil || jMap["errcode"] == 0 { accessToken, _ := jMap["access_token"].(string) return accessToken, nil } else { //返回错误信息 errcode := jMap["errcode"].(string) errmsg := jMap["errmsg"].(string) err = errors.New(errcode + ":" + errmsg) return "", err }} 获取小程序码12345678910111213141516171819202122232425262728293031323334353637func GetQRCode(id string) ([]byte, error) { //上面生成的access code 判断为空时重新请求 if appAccessTokenForClient == "" { accessToken, err := requestToken(appId, appSecret) if err != nil { return nil, err } appAccessTokenForClient = accessToken } strUrl := fmt.Sprintf("https://api.weixin.qq.com/wxa/getwxacode?access_token=%s", appAccessTokenForClient) parm := make(map[string]string) parm["path"] = fmt.Sprintf("pages/index/index?id=%s", id) jsonStr, err := json.Marshal(parm) if err != nil { return nil, errors.New("json Marshal QRCode paramter err :" + err.Error()) } req, err := http.NewRequest("POST", strUrl, bytes.NewBuffer([]byte(jsonStr))) if err != nil { return nil, errors.New("get QRCode err :" + err.Error()) } req.Header.Set("Content-Type", "application/json") client := &http.Client{} resp, err := client.Do(req) if err != nil { return nil, errors.New("get QRCode err :" + err.Error()) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, errors.New("get QRCode err :" + err.Error()) } return body, nil} 常见问题

整个过程主要在调试时比较费时间，微信接口返回的错误信息比较范，记录下主要遇到的几种问题

40159

{\"errcode\":40159,\"errmsg\":\"invalid length for path, or the data is not json string hint: [Id2VBa0339xa11]\"}

主要是检查传递的参数，特别是path对应的长度

我这边是因为从接口2修改为接口1，但是page参数名没有修改为path，导致系统判断path为空，一直提示此错误

40169

errCode: 40169 errMsg: "openapi.wxacode.getUnlimited:fail invalid length for scene, or the data is not json string rid: 62764ad3-09f60c12-58046222"

接口2中scene参数，最大32个可见字符，只支持数字，大小写英文以及部分特殊字符：!#$&’()*+,/:;=?@-._~，其它字符请自行编码为合法字符（因不支持%，中文无法使用 urlencode 处理，请使用其他编码方式）

【本文地址】

公司简介

联系我们