收藏
评论

小程序登录、用户信息相关接口调整说明官方

公告更新时间:2021年04月15日

考虑到近期开发者对小程序登录、用户信息相关接口调整的相关反馈,为优化开发者调整接口的体验,回收wx.getUserInfo接口可获取用户授权的个人信息能力的截止时间由2021年4月13日调整至2021年4月28日24时。

为优化用户的使用体验,平台将进行以下调整:

  1. 2021年2月23日起,若小程序已在微信开放平台进行绑定,则通过wx.login接口获取的登录凭证可直接换取unionID
  2. 2021年4月28日24时后发布的小程序新版本,无法通过wx.getUserInfo与<button open-type="getUserInfo"/>获取用户个人信息(头像、昵称、性别与地区),将直接获取匿名数据(包括userInfo与encryptedData中的用户个人信息),获取加密后的openID与unionID数据的能力不做调整。此前发布的小程序版本不受影响,但如果要进行版本更新则需要进行适配。
  3. 新增getUserProfile接口(基础库2.10.4版本开始支持),可获取用户头像、昵称、性别及地区信息,开发者每次通过该接口获取用户个人信息均需用户确认。具体接口文档:《getUserProfile接口文档》
  4. 由于getUserProfile接口从2.10.4版本基础库开始支持(覆盖微信7.0.9以上版本),考虑到开发者在低版本中有获取用户头像昵称的诉求,对于未支持getUserProfile的情况下,开发者可继续使用getUserInfo能力。开发者可参考getUserProfile接口文档中的示例代码进行适配。

请使用了wx.getUserInfo接口或<button open-type="getUserInfo"/>的开发者尽快适配。开发者工具1.05.2103022版本开始支持getUserProfile接口调试,开发者可下载该版本进行改造。

小游戏不受本次调整影响。

一、调整背景

很多开发者在打开小程序时就通过组件方式唤起getUserInfo弹窗,如果用户点击拒绝,无法使用小程序,这种做法打断了用户正常使用小程序的流程,同时也不利于小程序获取新用户。

二、调整说明

通过wx.login接口获取的登录凭证可直接换取unionID

若小程序已在微信开放平台进行绑定,原wx.login接口获取的登录凭证若需换取unionID需满足以下条件:

  1. 如果开发者帐号下存在同主体的公众号,并且该用户已经关注了该公众号
  2. 如果开发者帐号下存在同主体的公众号或移动应用,并且该用户已经授权登录过该公众号或移动应用

2月23日后,开发者调用wx.login获取的登录凭证可以直接换取unionID,无需满足以上条件。

回收wx.getUserInfo接口可获取用户个人信息能力

4月28日24时后发布的新版本小程序,开发者调用wx.getUserInfo或<button open-type="getUserInfo"/>将不再弹出弹窗,直接返回匿名的用户个人信息,获取加密后的openID、unionID数据的能力不做调整。

具体变化如下表:

即wx.getUserInfo接口的返回参数不变,但开发者获取的userInfo为匿名信息。




此外,针对scope.userInfo将做如下调整:

  1. 若开发者调用wx.authorize接口请求scope.userInfo授权,用户侧不会触发授权弹框,直接返回授权成功
  2. 若开发者调用wx.getSetting接口请求用户的授权状态,会直接读取到scope.userInfo为true

新增getUserProfile接口

若开发者需要获取用户的个人信息(头像、昵称、性别与地区),可以通过wx.getUserProfile接口进行获取,该接口从基础库2.10.4版本开始支持,该接口只返回用户个人信息,不包含用户身份标识符。该接口中desc属性(声明获取用户个人信息后的用途)后续会展示在弹窗中,请开发者谨慎填写。开发者每次通过该接口获取用户个人信息均需用户确认,请开发者妥善保管用户快速填写的头像昵称,避免重复弹窗。

插件用户信息功能页

插件申请获取用户头像昵称与用户身份标识符仍保留功能页的形式,不作调整。用户在用户信息功能页中授权之后,插件就可以直接调用 wx.login 和 wx.getUserInfo 。

三、最佳实践

调整后,开发者如需获取用户身份标识符只需要调用wx.login接口即可。

开发者若需要在界面中展示用户的头像昵称信息,可以通过<open-data>组件进行渲染,该组件无需用户确认,可以在界面中直接展示。

在部分场景(如社交类小程序)中,开发者需要在获取用户的头像昵称信息,可调用wx.getUserProfile接口,开发者每次通过该接口均需用户确认,请开发者妥善处理调用接口的时机,避免过度弹出弹窗骚扰用户。


微信团队

2021年4月15日


878146浏览
最后一次编辑于  2021-04-15
收藏

562 个评论

  • Why not?
    Why not?
    2021-02-25

    我们需要尽可能保持用户的头像和昵称是最新的,以前是只要授权了我们就可以静默更新,现在getUserProfile每次都要用户确认,不怕骚扰用户?

    2021-02-25
    赞同 33
    回复 22
    • 沈岸
      沈岸
      2021-02-25回复代松松柏之茂
      路已堵死,想获取用户昵称头像等信息就必须改
      2021-02-25
      5
      回复
    • 紫竹林
      紫竹林
      2021-02-26
      不获取这些信息也是可以的,用户不按照要求填写就不给用小程序。who 怕 who,人流量大了转app
      2021-02-26
      10
      回复
    • 浩
      2021-02-26
      开发者若需要在界面中展示用户的头像昵称信息,可以通过<open-data>组件进行渲染,该组件无需用户确认,可以在界面中直接展示。
      2021-02-26
      4
      回复
    • 阿卢说他遇到阿玮
      阿卢说他遇到阿玮
      2021-02-27回复
      一般都是要用户的数据保存到数据库中用到别的地方,不是单单为了展示而已
      2021-02-27
      6
      回复
    • Why not?
      Why not?
      2021-03-01回复
      经常需要展示其他用户的信息,open-data不够用的。而且open-data不需要用户授权,不怕用户误以为你窃取了他的信息吗?用户可不懂什么是open-data. 鸡肋加容易误解,所以我不用
      2021-03-01
      10
      回复
    查看更多(17)
  • 墨
    2021-02-26

    2021-02-26
    赞同 29
    回复
  • 三不
    三不
    2021-02-26
    s b,微信天天换,根本不考虑开发者的感受 ,人家都是做向下兼容 你们呢 ?天天坑开发者
    2021-02-26
    赞同 26
    回复
  • TTc
    TTc
    2021-02-25

    总结一下:

    1.login接口返回unionid了。这是需要通过union id打通小程序、公众号、app的开发者的福利,不用单单为了获取union id而要求用户授权信息了。因为login是静默的,所以以后不打扰用户了(这也是官方希望的)。

    2.getUserInfo接口以后就不能用了,完全静默不弹窗,但是里面的数据不包含用户的任何信息了。只有匿名信息(类似名字是“欢乐马”、头像是个随机头像)。加密信息里也依然有有效的openid和unionid(是否有匿名头像不确定、但肯定没有真实头像了)。目前看来这是官方为了兼容性,飞起了这个接口的同时,保证原来的程序不会报错,只是数据都是假的“随机头像和随机名称”了。

    3.getUserProfile接口代替以前的getUserInfo,这是一个全新接口。每次调用都弹窗,弹窗完成后返回明文不带id的数据,由程序自己处理如何操作这些真实的用户的头像和昵称(基本上就是传后端保存数据库吧)。

    官方把这个接口设计成了一个“快捷填写表单”的功能,用户点击这个按钮,授权,相当于快捷上传头像、自动填写昵称、地点、性别了。

    影响比较大的是,原来可以静默更新用户头像和昵称,现在不行了,现在需要用户主动同意,才能更新,虽然需要改代码很蛋疼,但是很合理。

    2021-02-25
    赞同 18
    回复 5
    • 卜鱼巷
      卜鱼巷
      2021-04-27
      感谢
      2021-04-27
      回复
    • TTc
      TTc
      2021-04-27回复卜鱼巷
      ^_^
      2021-04-27
      回复
    • 江上酒
      江上酒
      2021-05-11
      静默更新很方便唉,改成必须授权更新感觉对用户而言很不友好........假设用户之前在该小程序上授权过昵称头像,改过头像昵称后,下次继续使用该小程序,结果看到的头像和昵称还是之前的,这不是会很奇怪吗 = =,如果要更新还要弹窗给用户操作一下,对于用户而言岂不是多了些麻烦的交互操作.....
      2021-05-11
      回复
    • TTc
      TTc
      2021-05-11回复江上酒
      你可以把新的授权理解为,授权用户【当前】自己的头像和昵称,从而快捷填表的功能。如果你把程序设计成这样,用户就能理解了。下次进来,头像昵称变了肯定需要重新填表登记。
      2021-05-11
      1
      回复
    • 江上酒
      江上酒
      2021-05-12回复TTc
      嗯嗯 我明白你的意思了。不过有个场景还是不太好实现:仅当用户昵称头像变更了,才弹窗提示用户进行授权。 = =
      2021-05-12
      回复
  • Héctor2
    Héctor2
    2021-02-25

    请问4.13更新小程序之后, 那些基础库低于2.10.4的用户怎么处理

    2021-02-25
    赞同 15
    回复 10
    • 王建
      王建
      2021-02-25
      确实,难道再写一套 getUserInfo 的匿名兼容逻辑?
      2021-02-25
      1
      回复
    • 鲸鱼🐳在唱歌
      鲸鱼🐳在唱歌
      2021-03-02
      想知道答案 怎么处理 需要两个版本都兼容吗
      2021-03-02
      回复
    • Brother斌🎈
      Brother斌🎈
      2021-03-02回复鲸鱼🐳在唱歌
      小程序不是可以设置用户使用的最低基础库吗,用户低于设置的基础库会提示更新的
      2021-03-02
      1
      回复
    • 贺振军
      贺振军
      2021-03-04
      同问,基础库低于这个版本怎么处理,难道抛弃这部分用户?这也太霸道了吧
      2021-03-04
      1
      回复
    • 小尹
      小尹
      2021-03-05
      wx.login获取code,换取openid和unionid
      4.13后发布的小程序,getUserInfo按钮回调里判断是否支持getUserProfile接口,支持就通过该接口获取真实用户信息,否则就还是用getUserInfo的用户信息
      2021-03-05
      回复
    查看更多(5)
  • Memory
    Memory
    2021-02-24

    点赞收藏举报一键三连

    2021-02-24
    赞同 15
    回复 6
    • brave
      brave
      2021-02-24
      举报?
      2021-02-24
      2
      回复
    • Memory
      Memory
      2021-02-24回复brave
      哈哈哈,刚发现公告不可以举报
      2021-02-24
      4
      回复
    • 拾忆
      拾忆
      2021-02-25回复Memory
      举报你想举报公告
      2021-02-25
      4
      回复
    • 沈岸
      沈岸
      2021-02-25
      我去,还真不能举报。
      2021-02-25
      1
      回复
    • 小生蚝
      小生蚝
      2021-02-26
      哈哈哈你还想举报公告?
      2021-02-26
      3
      回复
    查看更多(1)
  • 黄正梦
    黄正梦
    2021-02-24
    大人 饶命啊
    2021-02-24
    赞同 13
    回复
  • 盖子
    盖子
    2021-03-30

    翻完了29页评论,总结下几点

    1. wx.getUserProfile()不能直接调,要在button里面bindtap手动调用
    2. 之前的wx.login()跟wx.getUserInfo()结合的方法现在不能用了,需要替换
    3. wx.getsetting()在wx.getUserProfile()授权之后还是不能获取到scope.userInfo为true,跟公告里面不一样
    4. 避免多次调用wx.getUserProfile(),如果用户更新头像或者昵称,就不能实时更新了
    2021-03-30
    赞同 12
    回复 1
    • 天涯小子
      天涯小子
      2021-04-30
      "之前的wx.login()跟wx.getUserInfo()结合的方法现在不能用了,需要替换" 这个要怎么替换?是不是wx.getUserProfile()换wx.getUserInfo()就行,我返回的encryptedData, iv给接口,返回结果不一样。不知道是不是有什么不同了
      2021-04-30
      回复
  • ______
    ______
    2021-02-26

    让我想起了2年多前的那个获取用户信息接口调整得公告,下面那个最高赞评论里的动图,链接在这

    2021-02-26
    赞同 10
    回复
  • 阿康
    阿康
    2021-02-25

    微信调整能力出了名一根筋,开发文档烂得跟什么一样。。。还有一堆的扫码限制,扫码摄像头,长按识别,麻烦死了,紧急情况下需要扫码,你在拉屎拉出来的一截你都要赶紧夹断去电脑边扫码先!

    2021-02-25
    赞同 10
    回复 5
    • 磊
      2021-03-05
      评论区都是段子啊
      2021-03-05
      回复
    • H.five
      H.five
      2021-03-23
      那是你没看过阿里的文档和开发,知足吧
      2021-03-23
      1
      回复
    • 刚刚
      刚刚
      2021-04-12
      我为了给你点个赞,拉屎拉一半夹断的来扫码登录的
      2021-04-12
      回复
    • 随风飘扬
      随风飘扬
      2021-04-15回复H.five
      我觉得阿里的比腾讯的好太多了
      2021-04-15
      回复
    • (;一_一)
      (;一_一)
      2021-04-20回复H.five
      阿里不会折腾开发人员
      2021-04-20
      回复

正在加载...

登录 后发表内容