Home

这是一个php+MySQL的api。有些环境只提供了运算能力，但是没有提供持久化存储，这时如果你有一个php+MySQL的环境，使用这个api就可以实现持久化存储，只需要按照api要求的字段向服务器发送get请求，就可以对数据进行读写、管理。
注意这并不是可以直接使用的工具，而是一个示例模板，用于提高新手的开发速度。

---

本api包含了如下功能模板：
1. 首次登陆返回提示信息（无需注册，首次登陆自动生成记录）
2. 1天内重复登陆记录登陆次数
3. 记录工作进度
4. 记录设备积分
5. 使用json格式展示排序信息（包含登陆时间筛选、进度排序、积分排序、输出数据量限制、数据量统计）

---

api需要从数据库中读写数据。可以使用如下命令新建一个表。

CREATE TABLE IF NOT EXISTS `table1` (
  `deviceId` text NOT NULL COMMENT '设备id',
  `step` int(11) NOT NULL DEFAULT '0' COMMENT '进度',
  `score` int(11) NOT NULL DEFAULT '0' COMMENT '积分',
  `today_login_count` int(11) NOT NULL DEFAULT '0' COMMENT '今日登陆次数',
  `date_login_count` int(11) NOT NULL DEFAULT '0' COMMENT '登录天数',
  `last_login_time` int(11) NOT NULL DEFAULT '0' COMMENT '今日登陆时刻'
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

---

在php文件中对需要对数据库信息进行设定
（服务器，用户名，密码，数据库名称，默认表名）

// 链接数据库
$con = mysqli_connect("mysql-t", "username", "password", "db-name");
if (!$con) {
    die("0");
    // 打印错误信息
    // die('Could not connect: ' . mysqli_error());
}

// echo 'conn ok';

//从请求中解析传递的必需参数
$table = $_GET['table'];
// 固定的数据库名。如果需要使用请求中的表名，请把此行注释掉
$table = 'table1';

---

使用api。需要构造诸如此类的url并对服务器发起get请求
其中mode参数是必须的。

// 首次登陆。deviceId不可为空。无需进行注册，首次登陆自动生成一笔记录
// https://path/api.php?mode=login&deviceId=ae1e916e76e5f2123377bb7e397d2ff1

// 更新积分。deviceId不可为空。
// score_differ字段如果不为空，score=score+score_differ;
// step字段如果不为空，setp=step。
// 返回值为数据库内deviceId对应的step+1
// https://path/api.php?mode=update&deviceId=ae1e916e76e5f2123377bb7e397d2ff1&score_differ=10

// 管理面板。返回json数据
// type == 'score'时，结果按照score进行排序。否则按照step排序。
// time <0 ，结果按当前时间+time进行筛选（即time=-60,现在时间为8:10，那么输出的结果是8:09后登陆的设备）time>0,按照>time进行筛选
// size 如果不为空，筛选size条结果。默认返回100条。
// https://path/api.php?mode=admin

// 排名信息
// mode=rank