抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端API介绍
  • 小游戏 OpenAPI SDK 总览
  • 接口调用凭证
  • 登录
  • code2Session
  • 用户登录态签名
  • checkSessionKey
  • resetSessionKey
  • 开放数据
  • 二维码
  • 订阅消息
  • 消息推送客服
  • 游戏礼包
  • 游戏内容安全
  • 推荐流直出游戏能力
  • 动态分享
  • 消息推送
  • 抖音客服平台-客服能力
  • Link链接
  • Schema链接
  • resetSessionKey

    收藏
    我的收藏

    接口说明

    重置服务器所保存的登录态 session_key 并返回新值

    使用限制

    单个appid下每分钟不能超过6w次

    基本信息

    名称描述
    HTTP URL
    https://minigame.zijieapi.com/mgplatform/api/apps/reset_session_key
    HTTP Method
    POST
    Scope
    open.ttgame.mgplatform
    权限要求
    重置服务器所保存的登录态 session_key 并返回新值

    请求参数

    请求头
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body
    access_token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    openid必填String
    用户唯一标识符
    sig_method必填String
    示例:hmac_sha256
    用户登录态key的签名方法,目前只支持 hmac_sha256
    signature必填String
    用户登录态key的签名
    请求示例
    curl --location --request POST 'https://minigame.zijieapi.com/mgplatform/api/apps/reset_session_key' \ --header 'content-type: application/json' \ --data '{"openid":"_000nHq5DzNNC9QsWOEE_AJBEXS-b01ol-F3","signature":"2e62381e164b0142bbf9cdb11417f15cc74efbd89e800654f90f673bd14e7176","sig_method":"hmac_sha256","access_token":"08011218474545706841787465683273643369666d6a703377513d3d"}'

    响应参数

    Body
    err_msg必填String
    错误信息
    err_no必填Int32
    错误码
    log_id必填String
    请求日志ID
    openid必填String
    用户唯一标识符
    session_key必填String
    重置后的用户登录态key
    响应示例
    正常响应示例异常响应示例
    { "err_msg": "", "err_no": 0, "log_id": "20250520145051C7448147A7B8F68A9D52", "openid": "_000nHq5DzNNC9QsWOEE_AJBEXS-b01ol-F3", "session_key": "dkLWEVhjZBJ0zh3zaPKBOg==" }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001003
    access_token无效
    获取最新的有效的access_token
    20028001004
    openID无效
    检查openID是否正确
    20028001038
    参数错误
    检查sig_method是否正确
    20028001039
    签名不正确
    检查signature的计算过程是否正确
    20028005139
    请求过于频繁,请稍后再试
    等待一段时间后重试
    20028001005
    系统内部错误,请重试
    重试请求或提oncall排查