# phonenumber.getPhoneNumber

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

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

code换取用户手机号。 每个 code 只能使用一次，code的有效期为5min

调用方式：

• HTTPS 调用
• 云调用

# HTTPS 调用

# 请求地址

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

# 请求参数

# 返回值

# Object

返回的 JSON 数据包

errcode 的合法值

phone_info 的结构

watermark 的结构

# 调用示例

curl -H "Accept: application/json" -H "Content-type: application/json" -X POST -d '{"code": "e31968a7f94cc5ee25fafc2aef2773f0bb8c3937b22520eb8ee345274d00c144"}' https://api.weixin.qq.com/wxa/business/getuserphonenumber?access_token=ACCESS_TOKEN&

# 返回结果示例

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

# 云调用

云调用是微信云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。

# 接口方法

openapi.phonenumber.getPhoneNumber

需在 config.json 中配置 phonenumber.getPhoneNumber API 的权限，详情

# 请求参数

# 返回值

# Object

返回的 JSON 数据包

errCode 的合法值

phoneInfo 的结构

watermark 的结构

# 异常

# Object

抛出的异常

errCode 的合法值