# auth.code2Session
# 接口说明
通过 tap.login() 接口获取到登录凭证后，开发者可以通过服务端 API 换取用户唯一标识 openid、用户在当前应用下的 unionid 和会话密钥 session_key。
# 接口地址
国内：
GET https://cloud-miniapp.tapapis.cn/auth/v1/jscode2session
国际：
GET https://cloud-miniapp.tapapis.com/auth/v1/jscode2session
# 请求参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| appid | string | 是 | MiniApp ID | |
| secret | string | 是 | 小游戏密钥 | |
| js_code | string | 是 | 登录时获取的 code | |
| grant_type | string | authorization_code | 是 | 授权类型，固定为 authorization_code |
# 返回结果
# 正常返回
{
"openid": "OPENID",
"session_key": "SESSIONKEY",
"unionid": "UNIONID"
}
| 属性 | 类型 | 说明 |
|---|---|---|
| openid | string | 用户在当前小游戏的唯一标识 |
| session_key | string | 会话密钥 |
| unionid | string | 用户在开放平台的唯一标识符，若当前小游戏已绑定到开放平台帐号下会返回，否则不返回 |
# 错误返回
{
"errcode": 40029,
"errmsg": "invalid code"
}
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
# 错误码
| 错误码 | 说明 |
|---|---|
| 1040029 | 无效的 code |
# 示例代码
# 请求示例
GET https://cloud-miniapp.tapapis.cn/auth/v1/jscode2session?appid=APPID&secret=SECRET&js_code=CODE&grant_type=authorization_code
# 返回示例
{
"openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
"session_key": "tiihtNczf5v6AKRyjwEUhQ==",
"unionid": "oR5Gjjs56whHYfUzlMYvlSWBhJKA"
}