# 登录凭证校验

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：code2Verifyinfo

通过 wx.xxxLogin（如 wx.weixinAppLogin、wx.appleLogin、wx.weixinMiniProgramLogin） 获得临时登录凭证 (code) 后，传到开发者服务器，开发者服务器调用本接口获取用户标识信息，可以用于构建自定义登录态。

本接口需要的多端应用secret，可在多端应用控制台应用详情页查看：

# 1. 调用方式

# HTTPS 调用

GET https://api.weixin.qq.com/donut/code2verifyinfo?access_token=ACCESS_TOKEN

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.login_info Object Payload

登录信息

# Res.user_info Object Payload

用户标识信息

# Res.user_info.openapp_info Object Payload

微信移动应用信息

# Res.user_info.miniprogram_info Object Payload

微信小程序信息

# Res.user_info.phone_info Object Payload

手机号信息

# Res.user_info.apple_info Object Payload

苹果信息

# 4. 注意事项

# 4.1 账号绑定说明

# 账号之间没有绑定

• 当 type 是 weixinMiniProgram（小程序登录） 的时候返回 miniprogram_info
• 当 type 是 weixinApp（微信登录） 的时候返回 openapp_info
• 当 type 是 phoneSms（手机验证码登录） 和 phoneOneClick（一键本机号码登录） 的时候返回 phone_info
• 当 type 是 apple 的时候返回 apple_info

# 账号之间有绑定

• 例如，小程序登录（wx.weixinMiniProgramLogin）后通过 wx.miniapp.bindPhone 引导用户完成了手机号绑定，那么，当 type 是 weixinMiniProgram（小程序登录） 的时候会同时返回 miniprogram_info 和 phone_info
• 同理，手机登录（wx.phoneSmsLogin）后通过 wx.miniapp.bindWeixin 引导用户完成了微信绑定，那么，当 type 是 phoneSms（手机验证码登录） 的时候会同时返回 phone_info 和 openapp_info
• 以此类推，不同的登录方式之间可以引导进行账号的绑定；code2Verifyinfo 接口会依据 type 以及已绑定的账号类型情况而同时返回对应的信息

# 4.2 常问问题

• Q：为什么我的返回信息中没有 phone_info / openapp_info？

• A：code2Verifyinfo 接口根据开发者调用的登录方式和账号间的绑定关系来返回对应信息。

  • 场景一：账号间没有绑定关系

    比如，传入微信小程序登录 wx.weixinMiniProgramLogin 获取的 code，code2verifyinfo 将返回微信小程序信息 miniprogram_info，但返回信息中不包含微信移动应用信息 openapp_info，手机号信息 phone_info，苹果信息 apple_info

  • 场景二：账号间存在绑定关系

    比如，某用户的手机号和苹果账号绑定，如果传入其中一种登录方式获取的 code，code2verifyinfo 将同时返回手机号信息 phone_info 和苹果信息 apple_info

    开发者可以调用 wx.miniapp.checkBindInfo 检查当前用户是否已经绑定某种账号

• Q：wx.login、wx.miniapp.login 获取的 code 可以在 code2verifyinfo 使用吗？

• A：wx.login、wx.miniapp.login 获取的 code 不支持在 code2verifyinfo 使用。

• Q：调用 code2verifyinfo 失败，报错为 {"errcode": 43001, "errmsg": "系统失败 rid: xxx"}，如何解决？

• A：请使用 get 发起请求。

# 5. 代码示例

请求示例

{
  appid: 'aaa',
  appsecret: 'bbb',
  code: 'ccc',
  grant_type: 'authorization_code'
}

返回示例

{
  errcode: 0,
  login_info: {
    type: 'weixinApp',
    login_time: 12345678,
    appid: 'aaa',
  },
  user_info: {
    user_id: 'xxx',
    openapp_info: {
      appid: 'bbb',
      openid: 'ccc',
      unionid: 'ddd',
      headimgurl: 'HEADIMGURL',
      nickname: 'NICKNAME'
    },
    phone_info: {
      phone: '137xxxxxxx'
    },
    apple_info: {
      bundleid: 'eee',
      apple_user_id: 'fff',
      apple_email:'xxx@test.com',
      is_apple_email_verified:false,
      is_apple_email_private:false
    },
    miniprogram_info: {
      appid: 'bbb',
      openid: 'ccc',
      unionid: 'ddd'
    },
  }
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 7. 适用范围

本接口支持「多端应用」账号类型调用。其他账号类型如无特殊说明，均不可调用。