收藏
评论

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

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

  1. 2021年2月23日起,若小程序已在微信开放平台进行绑定,则通过wx.login接口获取的登录凭证可直接换取unionID
  2. 2021年4月13日后发布的小程序新版本,无法通过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月13日后发布的新版本小程序,开发者调用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接口,开发者每次通过该接口均需用户确认,请开发者妥善处理调用接口的时机,避免过度弹出弹窗骚扰用户。

249738浏览
最后一次编辑于  03-30
收藏

411 个评论

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

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


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


    04-02
    赞同 6
    回复 76
    • 小石头
      小石头
      04-02
      眼看放假,下班的时候测试了一下;授权不弹出了;也获取不userinfo,都是空;我以为是我的代码问题都回退到验证登录之前了;哎好烦
      04-02
      36
      回复
    • 乐伊里
      乐伊里
      04-02
      made 晚上排查好久原来是要变了
      04-02
      15
      回复
    • 周大人
      周大人
      04-03回复小石头
      我也是排查好久,妈但
      04-03
      9
      回复
    • 兴,百姓苦;亡,百姓苦
      兴,百姓苦;亡,百姓苦
      04-03
      通宵走起吧
      04-03
      6
      回复
    • 刘宝华
      刘宝华
      04-03
      还没到13号就改了
      04-03
      18
      回复
    查看更多(71)
  • 社区技术运营专员-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
    赞同 2
    回复 7
    • zo
      zo
      04-07
      由于getUserProfile接口从2.10.4版本基础库开始支持(覆盖微信7.0.9以上版本),考虑到开发者在低版本中有获取用户头像昵称的诉求,对于未支持getUserProfile的情况下,开发者可继续使用getUserInfo能力。


      在开发工具和手机体验版低于2.10.4的基础版本下,getUserInfo获取不到用户信息啊,说好的可以继续使用呢?
      04-07
      7
      回复
    • 养乐多
      养乐多
      04-08
      意思是不支持wx.getUserProfile的只能通过wx.getUserInfo获取匿名信息?pc微信和某些基础库wx.getUserProfile is not a function该怎么适配呢?
      04-08
      回复
    • 华
      星期四 11:42
      你好,微信版本7.0.20都无法使用wx.getUserProfile 吗?
      星期四 11:42
      回复
    • trista
      trista
      星期四 12:12
      微信开发者工具拉不起来弹框,只能真机手势拉起来,不知道你们遇到这种问题没
      星期四 12:12
      回复
    • ontheway
      ontheway
      星期六 21:00回复zo
      我用的2.11.0的基础库都没有wx.getUserProfile,这个版本是wx.getUserProfile没有,wx.getUserInfo也没有了,让我怎么获取用户的信息,真是没脑子的平台
      星期六 21:00
      回复
    查看更多(2)
  • 社区技术运营专员-Jahozheng
    社区技术运营专员-Jahozheng
    置顶评论15小时前

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

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

    开发版 & 体验版 scope.userInfo 调整将于 4月13日 对齐。

    04-07
    赞同
    回复 32
    • 华
      星期四 11:43
      你好,微信版本7.0.20都无法使用wx.getUserProfile 吗?
      星期四 11:43
      1
      回复
    • Aurora.
      Aurora.
      星期四 14:07
      scope.userInfo还是会返回true的吗
      星期四 14:07
      2
      回复
    • 。。
      。。
      星期四 15:24
      今天发布的小程序已经是灰色头像和微信用户了。人事不干一点,能不能靠谱点。
      星期四 15:24
      3
      回复
    • 孙娉娉
      孙娉娉
      星期四 15:59
      scope.userInfo没有返回值啊,跟文档不一致啊,文档不是都是返回true
      星期四 15:59
      3
      回复
    • 。。。
      。。。
      星期五 11:15
      您好,现在的开发版和体验版使用wx.authorize({scope: "scope.userInfo"})设置这个的时候有报错,是不是开发版 体验版 scope.userInfo 4月13日才调整
      星期五 11:15
      回复
    查看更多(27)
  • 花ͨͨͨ里ͨͨͨ胡ͨͨͨ哨ͨͨͨ
    花ͨͨͨ里ͨͨͨ胡ͨͨͨ哨ͨͨͨ
    02-24
    人事不干一点,那么多bug修完了嘛
    02-24
    赞同 1457
    回复 261
    • ‮ 攻城狮
      ‮ 攻城狮
      02-25
      送你上去
      02-25
      54
      回复
    • 李锐泽
      李锐泽
      02-26
      顶送+++++
      02-26
      16
      回复
    • 江桥月
      江桥月
      03-03
      哈哈 ,你给我上去
      03-03
      19
      回复
    • もも
      もも
      03-04
      +++++++
      03-04
      16
      回复
    • Code Monkey
      Code Monkey
      03-04
      必须要抬你上去
      03-04
      17
      回复
    查看更多(256)
  • iMaeGoo
    iMaeGoo
    03-01

    (转)

    03-01
    赞同 261
    回复 26
    • ㅤㅤ
      ㅤㅤ
      03-05
      nice!我就知道会有这个!真·天天接废弃接口(掀桌!(╯‵□′)╯︵┻━┻ )
      03-05
      14
      回复
    • A MR.Z
      A MR.Z
      03-09
      人才,真是人才
      03-09
      6
      回复
    • 小李不小
      小李不小
      03-10
      微信不亡,天天得改。
      03-10
      9
      回复
    • Aland程先生
      Aland程先生
      03-11
      支持
      03-11
      回复
    • 宏
      03-12
      人才呀
      03-12
      4
      回复
    查看更多(21)
  • 物联网&系统&小程序_开发 李英浩
    物联网&系统&小程序_开发 李英浩
    02-24

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

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

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

    02-24
    赞同 90
    回复 33
    • ..
      ..
      02-25
      不改还不行!!!
      02-25
      17
      回复
    • @小明
      @小明
      02-26
      哪有程序员决定的道理,应该是产品经理互怼,最终受伤害的是程序员
      02-26
      35
      回复
    • 含光
      含光
      02-26
      改了又改,烦不烦
      02-26
      14
      回复
    • Aamir丶Dan
      Aamir丶Dan
      03-01
      我觉得现在的就很好,只授权一次啊,除非删除了小程序,才会再次获取授权啊。
      03-01
      7
      回复
    • smile
      smile
      03-02
      这个换取unionid意思是wx.login直接返回 还是拿code调接口换
      03-02
      10
      回复
    查看更多(28)
  • 细哥ᵀᴹ
    细哥ᵀᴹ
    02-24
    等了两年的功能
    02-24
    赞同 19
    回复 13
    • 前端开发小程
      前端开发小程
      03-02
      这我要个人中心获取用户头像啥的,还弹窗不成。每次调用都弹窗
      03-02
      6
      回复
    • 细哥ᵀᴹ
      细哥ᵀᴹ
      03-03回复前端开发小程
      用户关注了公众号  你好获取不到头像吗
      03-03
      3
      回复
    • 佩奇是头猪
      佩奇是头猪
      03-05回复前端开发小程
      保存用户信息啊
      03-05
      4
      回复
    • 王哈哈
      王哈哈
      03-09
      这个怎么保持用户头像最新呀 难道要定期让用户授权一次嘛? 或者是否可以提供一个可以查询用户信息是否 更改的接口呢 ?
      03-09
      8
      回复
    • L
      L
      03-09
      不改没头像,改了用户微信不升级还是没头像,我好男
      03-09
      5
      回复
    查看更多(8)
  • Why not?嗯?
    Why not?嗯?
    02-26

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

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

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

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

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

正在加载...

登录 后发表内容