简要描述:

  • 用户秘钥
  • 通过论坛用户名 得到基础SteamID信息获取接口
  • 可凭秘钥直接登录论坛

接口限制

  • 用户必须在论坛设置 安全码 未设置则不支持登录
  • 必须走HTTPS协议
  • 1天内超过2次不同省登录将自动重置用户安全码(海外IP以国家代码区分)

请求URL:

  • https://bbs.upkk.com/plugin.php?id=xnet_core_api:GetForumUserDetail

    请求方式:

  • POST

    请求头:

    |参数名|是否必须|类型|说明|
    |:—- |:—|:—– |—– |
    |Content-Type |是 |string |请求类型: application/json |

    请求参数:

    |参数名|是否必须|类型|说明|
    |:—- |:—|:—– |—– |
    |securecode |是 |string | 用户安全代码 | 需要使用URL编码+SHA512加密传输
    |username |是 |string | 使用URL编码 (论坛用户名称) |
    |timestmap |是 |int | 当前时间unix戳 |
    |clienthash |是 |string | 客户端特征码(可自定义 建议提交md5/sha1等加密后的客户端计算机名+MAC 或 硬盘ID等) |
    |token |是 |string | 令牌 | 组成方法 URL编码+SHA512(‘GetForumUserDetail’ + 当前时间格式:2020-06-20 + 参数username)

参数提交举例 【仅为参考 由于token 过期 将会返回500】

https://bbs.upkk.com/plugin.php?id=xnet_core_api:GetForumUserDetail&username=%E5%92%8C%E5%B9%B3%E5%8E%82%E5%95%86&timestamp=1593363100&securecode=3238112f5e790981cfc137ae44850da142dc0388500bc18b7f09fe82ec0de68499b005a4260f981f01d3e4fef9994e12efa11bbf06c1af46146620b2729cc75b&token=c7255dc056914f720f1c3f93319ff2f59b8aef52dfb4a3396727a57318183cafa6b33089d6c81aa94d1a2201014d743774a09575be052f6ce8b3a104acffbd16

返回示例:

正确时返回:

{
    "userdata": {
        "uid": "10000",
        "username": "testuser",
        "steamid64": "765611980704XXXXX",
        "steamid32": "STEAM_1:1:XXXXXX",
        "steamaccountid": "110XXXXX",
        "isLogin": "true",
        "user_token": "8b258cUzrEqJNEHy4UYm5XXXd3SJYH88gBTrZRU",
        'token_expire': "1593860000"
    }
}

错误时返回:

{
"errcode": 500,
"errmsg": "invalid"
}

备注:

  • user_token 即为临时令牌秘钥
  • token_expire 临时令牌有效到期时间
  • 自动登录储存密码建议只储存 加密编码后的用户和密码 以防文件传输用户信息泄露.
作者:admin  创建时间:2020-06-28 23:44
 更新时间:2022-05-10 23:12