收藏
评论

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

公告更新时间: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日


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

551 个评论

  • 社区技术运营专员-Jahozheng
    社区技术运营专员-Jahozheng
    置顶评论04-02

    周知:getUserInfo 开发版 & 体验版 已对齐 getUserInfo 匿名表现,正式版将于 4月13日 正式对齐 getUserInfo 匿名表现。请开发者使用 getUserProfile 获取用户信息。


    小程序登录、用户信息相关接口调整说明:https://developers.weixin.qq.com/community/develop/doc/000cacfa20ce88df04cb468bc52801


    04-02
    赞同 14
    回复 127
    • 小石头
      小石头
      04-02
      眼看放假,下班的时候测试了一下;授权不弹出了;也获取不userinfo,都是空;我以为是我的代码问题都回退到验证登录之前了;哎好烦
      04-02
      78
      回复
    • 乐伊里
      乐伊里
      04-02
      made 晚上排查好久原来是要变了
      04-02
      25
      回复
    • 周大人
      周大人
      04-03回复小石头
      我也是排查好久,妈但
      04-03
      20
      回复
    • 少吃一点吧
      少吃一点吧
      04-03
      通宵走起吧
      04-03
      13
      回复
    • 刘宝华
      刘宝华
      04-03
      还没到13号就改了
      04-03
      23
      回复
    查看更多(122)
  • 社区技术运营专员-Jahozheng
    社区技术运营专员-Jahozheng
    置顶评论04-13

    周知:小程序将暂缓调整公告 “小程序登录、用户信息相关接口调整说明” 中关于 4月13日 后发布的小程序将回收 wx.getUserInfo 接口可获取用户个人信息能力。回收时间近期内会确定并通知,建议开发者提前适配 wx.getUserInfo 接口回收场景。

    04-13
    赞同 6
    回复 41
    • Lorettay_
      Lorettay_
      04-13
      你这是在为难我胖虎
      04-13
      10
      回复
    • 豆浆油条
      豆浆油条
      04-13
      你这是在为难我胖虎
      04-13
      3
      回复
    • 雷亮
      雷亮
      04-13
      因为市面上很多代码都是老系统代码,有很多老板花了大价格购买的,这样上线根本无法使用,没有做到程序的向下兼容,设计是不合理的,php7都兼容php5很多代码,建议同时保留2个方法,新的建议开发者使用新的接口就好了,然后慢慢过度。
      04-13
      28
      回复
    • 神乐
      神乐
      04-13
      你妹呀,我刚上线 wx.getUserInfo 并不能直接获取数据,妈的
      04-13
      15
      回复
    • 小龙虾
      小龙虾
      04-14回复雷亮
      不错,学习了
      04-14
      2
      回复
    查看更多(36)
  • 社区技术运营专员-Jahozheng
    社区技术运营专员-Jahozheng
    置顶评论04-07

    pc微信暂不支持wx.getUserProfile,可以参考示例代码进行兼容

    https://developers.weixin.qq.com/miniprogram/dev/api/open-api/user-info/wx.getUserProfile.html#%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81

    04-07
    赞同 4
    回复 19
    • zo
      zo
      04-07
      由于getUserProfile接口从2.10.4版本基础库开始支持(覆盖微信7.0.9以上版本),考虑到开发者在低版本中有获取用户头像昵称的诉求,对于未支持getUserProfile的情况下,开发者可继续使用getUserInfo能力。


      在开发工具和手机体验版低于2.10.4的基础版本下,getUserInfo获取不到用户信息啊,说好的可以继续使用呢?
      04-07
      14
      回复
    • 养乐多
      养乐多
      04-08
      意思是不支持wx.getUserProfile的只能通过wx.getUserInfo获取匿名信息?pc微信和某些基础库wx.getUserProfile is not a function该怎么适配呢?
      04-08
      3
      回复
    • @华
      @华
      04-08
      你好,微信版本7.0.20都无法使用wx.getUserProfile 吗?
      04-08
      6
      回复
    • trista
      trista
      04-08
      微信开发者工具拉不起来弹框,只能真机手势拉起来,不知道你们遇到这种问题没
      04-08
      5
      回复
    • ontheway
      ontheway
      04-10回复zo
      我用的2.11.0的基础库都没有wx.getUserProfile,这个版本是wx.getUserProfile没有,wx.getUserInfo也没有了,让我怎么获取用户的信息,真是没脑子的平台
      04-10
      2
      回复
    查看更多(14)
  • 物联网&系统&小程序_开发 李英浩
    物联网&系统&小程序_开发 李英浩
    02-24

    ‘’2021年2月23日起,通过wx.login接口获取的登录凭证可直接换取unionID ” 这个非常好,利用数据的互通,减少一次用户交互和请求。

    “getUserProfile 可获取用户头像、昵称、性别及地区信息,开发者每次通过该接口获取用户个人信息均需用户确认” 这个也支持,防止用户信息被滥用。 改变是为了更好的体验。

    顺便说一句:程序员何苦为难程序员,又需要修改逻辑。

    02-24
    赞同 100
    回复 41
    • ..
      ..
      02-25
      不改还不行!!!
      02-25
      20
      回复
    • @小明
      @小明
      02-26
      哪有程序员决定的道理,应该是产品经理互怼,最终受伤害的是程序员
      02-26
      41
      回复
    • 含光
      含光
      02-26
      改了又改,烦不烦
      02-26
      15
      回复
    • Aamir丶Dan
      Aamir丶Dan
      03-01
      我觉得现在的就很好,只授权一次啊,除非删除了小程序,才会再次获取授权啊。
      03-01
      10
      回复
    • smile
      smile
      03-02
      这个换取unionid意思是wx.login直接返回 还是拿code调接口换
      03-02
      12
      回复
    查看更多(36)
  • Why not?
    Why not?
    02-26

    因为有些开发者不按规范设计小程序,就直接改接口改逻辑,让我们这些遵守规范的开发者跟着遭罪,是一个平台该有的样子吗!他们不授权用户信息就不给用小程序,损失的是他们,他们自己都不在意,你们多管个屁闲事

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

    02-26
    赞同 85
    回复 17
    • 米饭
      米饭
      03-05
      老哥,虽然我也觉得微信这次调整有些乱七八糟,但是我要反驳一下你。假设你开了一个大商场,你要吸引商铺入驻,如果入驻的每个商铺都特别受欢迎,你的商场就会很火,你就可以收更高的入驻金,赚更多的钱。但是,如果你的商场里有很多商铺卖屎,你的商场还能玩下去?“同时也不利于小程序获取新用户”,我觉得这句话的意思是:不利于微信小程序获取新用户,是指不利于整个微信小程序业态获取新用户,而不是指不利于某一个具体的小程序获取新用户。(影响的是整个商场,而不仅仅是那些卖屎的商铺。所以微信是在为自己的利益着想,并不是多管闲事)。最后还是要说一句:这次改动确实沙雕。
      03-05
      44
      回复
    • 玉之帝
      玉之帝
      03-05回复米饭
      哈哈,要不是最后一句话,妥妥的敌特
      03-05
      11
      回复
    • herock
      herock
      03-12回复米饭
      不是这样的,这种不按规范设计的小程序,应该通过审核机制来管理,而不是通过改接口,接口无论怎么改,滥用的人总能找到办法滥用,被连累的是大部分遵守规范的开发者。
      微信的管理思路有极大的问题。
      03-12
      20
      回复
    • a
      a
      03-17回复米饭
      貌似开发者社区的微信授权登录,也不能正常获取随意生成的神经蛙随机昵称头像,而是显示微信的真实头像和昵称。这玩意的业务逻辑大概也是旧的维持旧制,新的啥时候就启动新的,至于啥时候启用新机制,鬼知道。。。
      03-17
      3
      回复
    • MrZhou
      MrZhou
      03-19
      关键现在改成这个获取方式,用户拒绝授权的话,有些开发者一样可以停止用户使用小程序。
      03-19
      11
      回复
    查看更多(12)
  • 细哥ᵀᴹ
    细哥ᵀᴹ
    02-24
    等了两年的功能
    02-24
    赞同 23
    回复 14
    • 前端二次元
      前端二次元
      03-02
      这我要个人中心获取用户头像啥的,还弹窗不成。每次调用都弹窗
      03-02
      6
      回复
    • 细哥ᵀᴹ
      细哥ᵀᴹ
      03-03回复前端二次元
      用户关注了公众号  你好获取不到头像吗
      03-03
      3
      回复
    • 佩奇是头猪
      佩奇是头猪
      03-05回复前端二次元
      保存用户信息啊
      03-05
      4
      回复
    • 石头牛
      石头牛
      03-09
      这个怎么保持用户头像最新呀 难道要定期让用户授权一次嘛? 或者是否可以提供一个可以查询用户信息是否 更改的接口呢 ?
      03-09
      10
      回复
    • ᯤ
      03-09
      不改没头像,改了用户微信不升级还是没头像,我好男
      03-09
      5
      回复
    查看更多(9)
  • "
    02-24

    通过button的bindgetuserinfo获取用户信息 有影响吗?

    02-24
    赞同 19
    回复 26
    • Jet丶Z
      Jet丶Z
      02-25
      我也想知道这个到底受不受影响!!!有没有大佬出来解释一下!
      02-25
      11
      回复
    • 青玉
      青玉
      02-25
      我也想知道这个到底受不受影响!!!有没有官方出来解释一下!
      02-25
      4
      回复
    • 阿旺
      阿旺
      02-25
      说了数据格式没变化,但是返回的昵称头像 都是匿名的(估计也没啥可用价值)获取昵称和头像要更换接口了
      02-25
      6
      回复
    • 社区技术运营专员-索林
      社区技术运营专员-索林
      02-25
      也会同步修改,公告已经修改相关描述
      02-25
      7
      回复
    • 含光
      含光
      02-26
      有影响的
      02-26
      6
      回复
    查看更多(21)
  • 郑旭东
    郑旭东
    02-25

    用户已经快被各种弹窗弹没了,订阅消息、各种授权。请加快开放长期订阅、长期授权!

    02-25
    赞同 55
    回复 12
    • 前端二次元
      前端二次元
      03-02
      他这个新接口的话,没有判断用户是否授权,每一次使用小程序授权都要弹窗呀,这样用户体验很不好
      03-02
      7
      回复
    • 前端二次元
      前端二次元
      03-02
      这我要个人中心获取用户头像啥的,还弹窗不成
      03-02
      9
      回复
    • 石三
      石三
      03-05回复前端二次元
      弹一次你存到数据库就行了。
      03-05
      5
      回复
    • 郑旭东
      郑旭东
      03-05回复石三
      用户更新昵称头像后你不更新的吗?还用人家一年前的老头像?
      03-05
      5
      回复
    • 石三
      石三
      03-05回复郑旭东
      用户更新头像没必要每次去更新,设置一个更新信息的按钮就行。用户自己可以选择更新。
      03-05
      11
      回复
    查看更多(7)
  • CitizenFour
    CitizenFour
    02-24

    72个小程序,58个逻辑。一周时间没了

    02-24
    赞同 50
    回复 12
    • CitizenFour
      CitizenFour
      02-24
      微信的一小步,程序员的一大步,1024加油~
      02-24
      32
      回复
    • 前端二次元
      前端二次元
      03-02
      这我要个人中心获取用户头像啥的,每次打开都要弹窗不成?
      03-02
      4
      回复
    • 前端二次元
      前端二次元
      03-02回复CitizenFour
      这么修改哪里好了呀,这我要个人中心获取用户头像啥的,每次打开都要弹窗,还必须按钮授权
      03-02
      5
      回复
    • Life
      Life
      03-02
      哈哈,你可以不迭代啊
      03-02
      3
      回复
    • ㅤH
      ㅤH
      03-03回复前端二次元
      可以改成更新用户信息的逻辑,头像昵称之类等等,都是次要的
      03-03
      3
      回复
    查看更多(7)
  • Why not?
    Why not?
    02-25

    发公告的时候麻烦文档也同步更新一下,不然让我们根据什么调整?公告写得这么粗糙

    02-25
    赞同 42
    回复 10
    • 洛特
      洛特
      03-08
      公告貌似写的很专业,其实就是来回那么点说法,找一个要改的借口罢了,说来说去就是在程序里面把原来的getUserInfo改成getUserProfile,一句话写清楚的事情,扯淡这么多
      03-08
      7
      回复
    • 幽幽晚来风
      幽幽晚来风
      03-10回复洛特
      这公告改了好几遍了,所以……
      03-10
      回复
    • Z.Y.1 ⁵ᴳ
      Z.Y.1 ⁵ᴳ
      03-11回复洛特
      不扯 这么多,周报/日报写啥呢~
      03-11
      5
      回复
    • 玉之帝
      玉之帝
      03-16回复Z.Y.1 ⁵ᴳ
      确实,字数不够怎么给你小红花
      03-16
      1
      回复
    • 庞
      04-02
      微信的部分人员 是不是闲的蛋疼啊。搞事情 啊
      04-02
      4
      回复
    查看更多(5)

正在加载...

登录 后发表内容