跳转至

验证 weblogin v1

网络登录验证 v1

API在登录后验证登录信息。

  • 请求 URL
    商业服务器 URL https://weblogin.withhive.com/verify
    沙盒 URL https://sandbox-weblogin.withhive.com/verify
  • 请求 头部
    HTTP 方法 POST
    内容类型 application/json
  • 请求
    字段名称 类型 描述 必需
    param 字符串

    param 字符串值是通过对下面表格中键值组成的 JSON 数据进行 URL 编码和 BASE64 编码创建的。

  • 请求 主体 - param
    字段名称 类型 描述
    token 字符串 在Web登录v1成功时接收到的作为响应值的token信息。
    pid 字符串 在Web登录v1成功时接收到的作为响应值的玩家ID信息。
  • 请求示例
    // the original param composed of JSON object. The string value obtained by performing the URL encoding and the BASE64 encoding sequentially on this JSON object is used as the request body when calling the API.
    {
        "token": "1627881984263-jkx1B3GOY3EsJ",
        "pid": "20000009891"
    }
    // the URL encoding and BASE64 encoding result
    JTdCJTIydG9rZW4lMjIlM0ElMjIxNjI3ODgxOTg0MjYzLWpreDFCM0dPWTNFc0olMjIlMkMlMjJwaWQlMjIlM0ElMjIyMDAwMDAwOTg5MSUyMiU3RA==
    
    //Curl example. 
    // Call the API attaching the encoded param in the request body.
    curl -X POST https://weblogin.withhive.com/verify
        -H "Content-Type: application/json"
        -d "{'param': 'JTdCJTIydG9rZW4lMjIlM0ElMjIxNjI3ODgxOTg0MjYzLWpreDFCM0dPWTNFc0olMjIlMkMlMjJwaWQlMjIlM0ElMjIyMDAwMDAwOTg5MSUyMiU3RA=='}"
    
  • 响应 主体

    返回一个代码,显示验证是否成功。

    字段名称 描述 类型 是否必需
    code 验证成功的结果代码 int
     
    code 描述
    100 成功
    500 登录内部服务器错误(内部服务器错误,例如中间件服务器不可用和数据库服务器连接不可用)
    1050 请求主体中的参数值不是Json格式。
    1066 请求主体不存在。
    2005 参数值不存在。
    2200 令牌无效。令牌已过期或令牌已用于验证。
    2201 验证失败。验证令牌值不匹配。
    2202 验证失败。用于验证的PlayerID不匹配。
  • 响应 示例<
    {
        "code": "100";
    }