返回

用户系统API

登录

---

创建一个链接，将href设置为：
https://api.xuanzhi33.cn/v1/usersystem/?appname=[您的应用名称]&from=[返回地址]

验证登录状态

---

用户登录完毕后，会被重定向到[返回地址]，这时候会在URL中传过来两个参数：

参数名称	作用	格式
username	用户的用户名，作为用户的唯一标识	一个15位以内的字符串，可能是中文
usertoken	用户的token，作为验证的凭据	一个32位的字符串，只含字母和数字

然后，你需要验证传入的token是否合法，来确保用户是真的登录过了。
你的服务器需要向我的服务器发送一个GET请求，格式如下：
https://api.xuanzhi33.cn/v1/usersystem/check/?key=[您的APIKEY]&username=[刚刚传过来的username]&usertoken=[刚刚传过来的usertoken]

其中，[您的APIKEY]请向我索要，邮箱：xuanzhi33@qq.com，单次调用无论是否成功均扣除apikey的2次调用次数。

服务器的返回格式是一个json：
示例：{"msg":"success","data":{"result":"YES","info":"用户：xuanzhi33 验证结果为：真","times":9976}}

参数名称	作用	格式
result	验证结果	“YES”表示验证结果为真，“NO”表示验证验证结果为假
info	状态信息	一句中文描述
times	剩余调用次数	一个整数

下面为PHP语言请求示例代码：

  <?php
    $url="https://api.xuanzhi33.cn/v1/usersystem/check/";
    $apikey="[您的APIKEY]";

    $username=$_GET["username"]; //获取传入的username
    $usertoken=$_GET["usertoken"]; //获取传入的usertoken
    if (json_decode(file_get_contents($url."?apikey=".$apikey."&username=".$username."&usertoken=".$usertoken))->data->result=="YES")
    {
      //在这里可以执行您自己想实现的操作
      //比如设置cookie来辨别用户：
      $username=$_GET["username"];
      setcookie("my_user",$username,time()+3600*24*30,"/");
      echo "登录成功！用户名为：".$_GET["username"];

    };