tencent cloud

小程序登录
下载PDF
最后更新时间：2025-10-28 11:05:04
小程序登录
最后更新时间： 2025-10-28 11:05:04
下载PDF
说明：
仅公有云支持。

jscode2session

调用方式：get。
请求地址：/openserver/sns/jscode2session。

请求参数

属性
类型
必填
说明
appid
string
是
小程序 appId
secret
string
是
小程序 appSecret
js_code
string
是
登录时获取的 code
grant_type
string
是
授权类型 authorization_code

返回参数

属性
类型
必填
说明
session_key
string
是
会话密钥
errmsg
string
是
错误信息
openid
string
是
用户唯一标识
unionid
string
是
如果小程序团队拥有多个小程序、小游戏，可通过 UnionlD 来区分用户的唯一性，只要是同一个小程序团队下的小程序、小游戏，用户的 UnionlD 是唯一的。换句话说，同一用户，在同一个 App 内，同一小程序团队下的不同小程序、小游戏登录后，UnionlD 是相同的。
errcode
int32
是
错误码
{
    "errcode": 40029,
    "errmsg": "invalid js_code",
    "openid": "",
    "requestId": "84574d84227943298cb25e26a6d2b816",
    "session_key": "",
    "unionid": ""
}

getAccessToken

调用方式：get。
请求地址：/openserver/cgi-bin/token。

请求参数

属性
类型
必填
说明
appid
string
是
小程序 appId
secret
string
是
小程序 appSecret
grant_type
string
是
填写:client_credential

返回参数

属性
类型
必填
说明
access_token
string
是
获取到的凭证
expires_in
number
是
凭证有效时间，单位：秒。目前是7200秒
{
    "access_token": "ATZrSqJXfZkAZVRIJxTNZJwyZLZJjPJhKpibbjuGgHpQzZwbCDPvGGfWKSbJlSMX",
    "errcode": 0,
    "errmsg": "ok",
    "expires_in": 7200,
    "requestId": "5486f23fd3b64c2c84c9798ead510aa7"
}

checkSessionKey

调用方式：get。
请求地址：/openserver/wxa/checksession。

请求参数

属性
类型
必填
说明
access_token
string
是
接口调用凭证
openid
string
是
用户唯一标识符
signature
string
是
用户登录态签名，用 session_key 对空字符串签名得到的结果。即 signature = hmac_sha256(session_key, "")
sig_method
string
是
用户登录态签名的哈希方法，目前只支持 hmac_sha256

返回参数

属性
类型
必填
说明
errcode
number
是
错误码
errmsg
string
是
错误信息

获取手机号

调用方式：post。
请求地址：/openserver/wxa/business/getuserphonenumber。

请求参数

属性
类型
必填
说明
access_token
string
是
接口调用凭证
openid
string
是
用户唯一标识符
code
string
是
临时凭证 code，该参数由 JSSDK 调用 wx.getPhoneNumber 接口获取
{
    "access_token":"ATIfWyEpUVHcyGHHqCEspuuALGNyoBFpLwTNdRMLsdJAdJPEJHvrEYSlhZQtJojF",
    "openid":"b642cf744a16d2010b60242ab6b7ded99a895a60e857a9dc17eadcb73f790cfd",
    "code":"807636166d9c4155aacc7fbeae7b9bfa"
}

返回参数

属性
类型
说明
errcode
number
错误码
errmsg
string
错误信息
phone_info
object
手机信息
phone_info.phoneNumber
string
手机号
{
    "errcode": 0,
    "errmsg": "ok",
    "phone_info": {
        "phoneNumber": "xxxxxx"
    }
}

获取邮件地址

调用方式：post。
请求地址：/openserver/wxa/business/getemailaddress。

请求参数

属性
类型
必填
说明
access_token
string
是
接口调用凭证
openid
string
是
用户唯一标识符
code
string
是
临时凭证 code，该参数由 JSSDK 调用 wx.getEmailAddress 接口获取
{
    "access_token":"ATIfWyEpUVHcyGHHqCEspuuALGNyoBFpLwTNdRMLsdJAdJPEJHvrEYSlhZQtJojF",
    "openid":"b642cf744a16d2010b60242ab6b7ded99a895a60e857a9dc17eadcb73f790cfd",
    "code":"807636166d9c4155aacc7fbeae7b9bfa"
}

返回参数

属性
类型
说明
errcode
number
错误码
errmsg
string
错误信息
email_address
object
邮箱信息
email_address.emailAddress
string
邮箱地址

本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈