code2Session
收藏接口说明
通过tt.login接口获取到登录凭证后，开发者可以通过服务器发送请求的方式获取 session_key 和 openid。
匿名 openid 数据迁移
Bug & Tip
- Tip：原域名 https://developer.toutiao.com/api/apps/jscode2session 仍然可用，不过为了后续兼容性和可能的迁移，建议开发者更换到新的域名。
- Tip: 为了保障应用的数据安全，只能在开发者服务器使用 AppSecret；开发者服务器不应该把会话密钥下发到小游戏，也不应该对外提供这个密钥。如果小游戏存在泄露 AppSecret 或会话密钥的问题，字节小游戏平台将有可能下架该小游戏，并暂停该小游戏相关服务。
- Tip：登录凭证 code，anonymous_code 只能使用一次，非匿名需要 code，非匿名下的 anonymous_code 用于数据同步；匿名需要 anonymous_code。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://minigame.zijieapi.com/mgplatform/api/apps/jscode2session |
| HTTP Method | GET |
| Scope | open.ttgame.mgplatform |
| 权限要求 | 通过tt.login接口获取到登录凭证后，开发者可以通过服务器发送请求的方式获取 session_key 和 openid。
Tip：登录凭证 code，anonymous_code 只能使用一次，非匿名需要 code，非匿名下的 anonymous_code 用于数据同步；匿名需要 anonymous_code。 |
请求参数
请求头
content-type必填String
固定值"application/json"
Query
appid必填String
小游戏 ID
secret必填String
小游戏的 APP Secret，可以在「开发者后台->开发管理->开发设置」获取
anonymous_codeString
tt.login 接口返回的匿名登录凭证（code 和 anonymous_code 至少要有一个）
codeString
tt.login 接口返回的登录凭证（code 和 anonymous_code 至少要有一个）
请求示例
curl --location --request GET '/mgplatform/api/apps/jscode2session?code=ixc2uqaT4i&anonymous_code=VAd4NTMgID&appid=ZphAu15AuH&secret=3bWDiB4unz' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ # 此示例仅为模板，请修改为更加符合业务规则的调用示例，方便开发者查看
响应参数
Body
error必填Int64
错误号 返回非 0
anonymous_openidString
匿名用户在当前小游戏的 ID，如果请求时有 anonymous_code 参数才会返回
errcodeInt64
详细错误号
errmsgString
错误信息
messageString
错误信息（同 errmsg）
openidString
用户在当前小游戏的 ID，如果请求时有 code 参数才会返回
session_keyString
会话密钥，如果请求时有 code 参数才会返回
unionidString
用户在小游戏平台的唯一标识符，请求时有 code 参数才会返回。如果开发者拥有多个小游戏，可通过 unionid 来区分用户的唯一性。
响应示例
{ "anonymous_openid": "hc9C09Vns8", "message": "HwoBg4f8qn", "errcode": 5863662523178857000, "unionid": "HQfWTvhMSu", "errmsg": "Sw50DkJoJD", "error": 249511400562618660, "openid": "gTEOMhMM0i", "dopenid": "tejmaE0Dop", "session_key": "AAz1AuKRKN" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | 请求成功 | |
| 200 | -1 | 系统错误 | |
| 200 | 40014 | 未传必要参数，请检查 | |
| 200 | 40015 | appid 错误 | |
| 200 | 40017 | secret 错误 | |
| 200 | 40018 | code 错误 | |
| 200 | 40019 | acode 错误 |
