# 获取手机号

调试工具

接口应在服务器端调用，详细说明参见服务端 API>)。

本接口支持云调用>)。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

getPhoneNumber

# 功能描述

该接口用于将 code 换取用户手机号。 说明，每个 code 只能使用一次，code 的有效期为 5min。

# 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/business/getuserphonenumber?access_token=ACCESS_TOKEN

# 云调用

• 出入参和 HTTPS 调用相同，调用方式可查看云调用说明文档

• 接口方法为: openapi.phonenumber.getPhoneNumber

# 第三方调用

• 调用方式以及出入参和 HTTPS 相同，仅是调用的 token 不同

• 该接口所属的权限集 id 为：18

• 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数 - Query

# 请求参数 - Body

# 返回参数

# 调用示例

示例说明: HTTPS 请求示例

# 请求数据示例

{
  "code": "e31968a7f94cc5ee25fafc2aef2773f0bb8c3937b22520eb8ee345274d00c144"
}

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok",
  "phone_info": {
    "phoneNumber": "xxxxxx",
    "purePhoneNumber": "xxxxxx",
    "countryCode": 86,
    "watermark": {
      "timestamp": 1637744274,
      "appid": "xxxx"
    }
  }
}

# 错误码