要把小程序码长期印在海报上,先要分清用哪一种官方接口来生成这张码。2026年11月20日(北京时间)阅读的微信开放文档里,概述页《获取小程序码》把这件事分成两套主要接口:接口 A 适用于需要的码数量较少的业务场景,可接受 path 参数较长,但生成个数受限;接口 B 适用于需要的码数量极多的业务场景,可接受页面参数较短,生成个数不受限。对应的接口页分别称为「获取小程序码」和「获取不限制的小程序码」。概述页写明「所有生成的小程序码永久有效」,两份接口页也各自写了「永久有效」,所以「能不能长期放」不能只看有效期这一句,还要对照数量、参数方式和调用频率。概述页的页标是「最后一次编辑于 2026-07-23」,两份接口页的页标都是「最后一次编辑于 2026-11-04」。以下只转述这些页面的现行写法。本文不提供生成可扫描真码的逐步操作,也不把趣码或其他工具写成已经接入这些接口。

概述页开头写:通过后台接口可以获取小程序任意页面的小程序码,扫描该小程序码可以直接进入小程序对应的页面,所有生成的小程序码永久有效,可放心使用。它还推荐使用小程序码,称辨识度更好,且可展示「公众号关注组件」等高级能力。
概述页接着说,为满足不同需求和场景,这里提供了两个接口,开发者可挑选适合自己的接口。接口 A 面向码数量较少的场景,并提醒「请谨慎使用」;接口 B 面向码数量极多的场景。接口页把同一组区别写得更短:「获取小程序码」适用于码数量较少的业务场景,永久有效,有数量限制;「获取不限制的小程序码」适用于码数量极多的业务场景,永久有效,数量暂无限制。
有两处需要原样保留。第一,概述页写接口 B「生成个数不受限」,接口 B 页写「数量暂无限制」,多了一个「暂无」,本文并列转述,不改成同一种保证。第二,「永久有效」说的是已经生成的小程序码本身,并不能用来区分该选 A 还是选 B。
概述页另外写了「获取小程序二维码(不推荐使用)」,对应接口 C:适用于码数量较少的场景,生成的是二维码而不是小程序码,可接受 path 参数较长,生成个数同样受限。下文只在数量上限处带过接口 C。该页还出现了微信「一物一码」,这是官方另列的对象,不是接口 A 或接口 B,本文不展开。
概述页「注意事项」写:接口 A 加上接口 C,总共生成的码数量限制为 100,000,请谨慎调用。接口 A 页则写成:与 createQRCode 总共生成的码数量限制为 100,000,请谨慎调用;并补充已生成码数量可参考 HTTP 头部的 Num-Used。两页都出现了 100,000 这个合计上限,但一页写「接口 A 加上接口 C」,另一页写「与 createQRCode」。本文把这两种写法并列记下,不在页面没有互相指明时自行合并成同一个名称。接口 A 的错误说明里还有「生成码个数总和到达最大个数限制」。
接口 B 的限制写在调用频率上:概述页和接口 B 页都写,调用分钟频率受限,为 5000 次/分钟;如需大量小程序码,建议预生成。也就是说,B 并不是没有任何限制,只是这几页没有给它写一个与 A、C 同类的生成个数上限,而是写了每分钟可调用的次数,并建议大量使用时先预生成。这几页都没有提供突破 100,000 合计上限的办法,本文也不讨论如何绕过数量限制。海报若只需少量、长期使用的码,要先看见接口 A「生成个数受限」;若预计数量会很多,则要转到接口 B,同时把 5000 次/分钟和「建议预生成」一并考虑,而不能理解成可以无限制地即时生成。
概述页写:接口 A 可接受 path 参数较长;接口 B 可接受页面参数较短。接口 A 页把这条路径参数写成必填的 path:扫码进入的小程序页面路径,最大长度 1024 个字符,不能为空;并写明 scancode_time 为系统保留参数,不允许配置。对应的错误说明是:path 不能为空,且长度不能大于 1024。
接口 B 页不用 path 这个字段,而是把必填项写成 scene,可选项写成 page。scene 最大 32 个可见字符,只支持数字、大小写英文以及部分特殊字符;其他字符请自行编码为合法字符,并特别写明因不支持 %,中文无法使用 urlencode 处理,请使用其他编码方式。page 默认是主页,例如 pages/index/index,根路径前不要填加 /,不能携带参数,参数请放在 scene 字段里;不填写 page 时,默认跳主页面。scancode_time 在这里同样不允许配置。
接口 B 页还说明:scene 的值会作为 query 参数传递给小程序或小游戏,用户扫描该码进入后,开发者可以获取到码中的 scene 值再做处理,获取时需要先做解码。这些是官方对「扫码后如何读到参数」的说明,不是生成步骤。需要区分不同来源或不同内容时,先要看这次携带的信息能不能放进 A 的路径写法,或能不能收进 B 所允许的场景值长度和字符范围。两份接口页都还可以指定要打开的小程序版本:正式版、体验版或开发版,默认是正式版。这与下面「是否必须是已发布小程序」的表述有关,需要对照着看。
概述页注意事项的第一条是:「接口只能生成已发布的小程序的二维码。」按这句,生成条件被写成小程序已经发布。
接口 B 页则另外给出了检查页面是否存在的开关,字段名为 check_path,默认值是 true。为 true 时,page 必须是已经发布的小程序存在的页面,否则报错;为 false 时,允许小程序未发布或者 page 不存在,但 page 有数量上限,为 60000 个,并写明请勿滥用。错误说明里也写到,设置该检查开关为 false 时可不检查 page 参数。
这两处不能自行调和。概述页把「只能生成已发布的小程序的二维码」写成注意事项;接口 B 页则在默认检查已发布页面的同时,也写了关闭检查时允许未发布或不存在页面,并给出了页面数量上限。接口 A 页没有写出这样一个检查开关。此外,两份接口页都允许把要打开的版本设为体验版或开发版,默认仍是正式版。这与概述页那一句是否指同一范围,页面没有互相解释,本文也不把它收成一句。接口页还写明:接口应在服务器端调用,不可在前端(小程序、网页、APP 等)直接调用。两页都写了个人小程序须通过主体认证后,才可生成并使用小程序码,只是错误说明的编号并不相同。
要在海报上长期放一张小程序码,可以按这几页已经写出的条件来对照,而不要先把「永久有效」理解成已经选好了接口。
第一,有效期:概述页和两份接口页都写了永久有效。就这几页而言,码本身的有效期并不是 A 和 B 的分界点。
第二,数量:只需少量码时看接口 A,并记住概述页写明 A 与接口 C 合计上限是 100,000,接口 A 页写的是与 createQRCode 合计 100,000。需要极多码时看接口 B,同时记下「数量暂无限制」或「生成个数不受限」的原文,以及 5000 次/分钟和「建议预生成」。不要去寻找这几页没有给出的突破数量上限的办法。
第三,参数方式:要把较长页面路径直接放进码里时,对应接口 A 的 path,最长 1024 个字符;要把参数和页面分开时,对应接口 B 的 scene 和 page,scene 最长 32 个可见字符,字符范围按接口页的规定来。
第四,是否必须已发布:概述页写只能生成已发布的小程序的二维码;接口 B 页另有检查页面是否存在的开关,默认检查已发布页面,关闭检查时另有自己的条件与页面数量上限。两页表述不一致的地方要并列看待,不要用其中一页去改写另一页。
第五,接口 C 是概述页标明「不推荐使用」的小程序二维码,与接口 A 一并计入数量上限,不作为本文的首选。微信「一物一码」也不是接口 A 或接口 B。
这些条目只用来判断该对照哪一层官方说明,不能写成「按这个顺序操作就能生成可扫描的真码」。本文未登录小程序后台,也未调用上述接口,不把某一次生成或扫描结果写成已经核实的保证。最终仍以当时对照这些官方页面核对的结果为准。
[1] 获取小程序码 https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/qr-code.html,最后一次编辑于 2026-07-23,访问日期 2026-11-20(北京时间)。
[2] 获取小程序码 https://developers.weixin.qq.com/miniprogram/dev/server/API/qrcode-link/qr-code/api_getqrcode.html,最后一次编辑于 2026-11-04,访问日期 2026-11-20(北京时间)。
[3] 获取不限制的小程序码 https://developers.weixin.qq.com/miniprogram/dev/server/API/qrcode-link/qr-code/api_getunlimitedqrcode.html,最后一次编辑于 2026-11-04,访问日期 2026-11-20(北京时间)。
