抖音开放平台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"
    Query
    access_token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    openid必填String
    用户唯一标识符
    sig_method必填String
    用户登录态签名的哈希方法,目前只支持 hmac_sha256
    signature必填String
    用户登录态签名
    请求示例
    curl --location --request GET '/mgplatform/api/apps/check_session_key?openid=101iRKD9B8&signature=fZ54KOcwUF&sig_method=RcZDBgzfuF' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ # 此示例仅为模板,请修改为更加符合业务规则的调用示例,方便开发者查看

    响应参数

    Body
    err_msg必填String
    错误信息
    err_no必填Int32
    错误码
    log_id必填String
    请求日志ID
    响应示例
    { "err_no": 7565327835410406000, "err_msg": "3j4tBh2bfa", "log_id": "9PQ6o2VS40" }
    切换单列布局

    错误码

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