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

    收藏
    我的收藏

    接口说明

    校验服务器所保存的登录态 session_key 是否合法

    基本信息

    名称描述
    HTTP URL
    https://minigame.zijieapi.com/mgplatform/api/apps/check_session_key
    HTTP Method
    GET
    Scope
    open.ttgame.mgplatform
    权限要求
    校验服务器所保存的登录态 session_key 是否合法

    请求参数

    请求头
    content-type必填String
    示例:application/json
    固定值"application/json"
    Query
    access_token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    openid必填String
    示例:_000nHq5DzNNx9nNWOEE_AJBEXS-b01ol-E5
    用户唯一标识符
    sig_method必填String
    示例:hmac_sha256
    用户登录态签名的哈希方法,目前只支持 hmac_sha256
    signature必填String
    示例:2e62381e164b0142bbf9cdb11417f15cc74efbd89e800654f90f673bd14e7176
    用户登录态签名
    请求示例
    curl --location --request GET 'https://minigame.zijieapi.com/mgplatform/api/apps/check_session_key?openid=_000nHq5DzNNx9nNWOEE_AJBEXS-b01ol-E5&signature=2e62381e164b0142bbf9cdb11417f15cc74efbd89e800654f90f673bd14e7176&sig_method=hmac_sha256&access_token=080112184745453548436d332b764a35493643713663735074673d3d' \ --header 'content-type: application/json' \

    响应参数

    Body
    err_msg必填String
    错误信息
    err_no必填Int32
    错误码
    log_id必填String
    请求日志ID
    响应示例
    正常响应示例异常响应示例
    { "err_no": 0, "err_msg": "", "log_id": "20250528154636C3DD5EA834B0BF27F544" }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001003
    access_token无效
    重新获取有效的access_token
    20028001004
    open_id 无效
    检查传入的登录用户的openID有效
    20028001038
    参数错误
    检查请求参数是否正确,如sig_method
    20028001039
    签名不正确
    检查生成的签名是否正确