务必使用 https:
务必使用 https:
务必使用 https:
之前的 TODO API 存在一些问题,目前根据大家的反馈,对 TODO 列表增加了更多的可定制的 API。
TODO 因为要区分用户,所以必须在登录的情况下才能访问。
你可以在这里网页版新增几个 todo。
强烈建议先体验网页版 TODO。
然后可以直接访问列表查看大致的数据。
如果你需要制作app,需要参考本站所有open api中的登录部分。
强烈建议,所有的接口通过postman 调试清楚后再写app:
Postman 模拟带 cookie 的请求该文章,用户账号密码是明文,用于测试的,在线上环境会被加密传输。
可参考的开源 TODO app:
- https://github.com/wjwang0914/wj-todo-wanandroid 使用的老接口,可参考。
1. 新增一个 TODO
https://www.wanandroid.com/lg/todo/add/json
方法:POST
参数:
title: 新增标题(必须)
content: 新增详情(必须)
date: 2018-08-01 预定完成时间(不传默认当天,建议传)
type: 大于0的整数(可选);
priority 大于0的整数(可选);
type 可以用于,在app 中预定义几个类别:例如
- 工作1;
- 生活2;
- 娱乐3;
新增的时候传入1,2,3,查询的时候,传入type 进行筛选;
如果不设置type则为 0,未来无法做 type=0的筛选,会显示全部(筛选 type 必须为大于 0 的整数)
priority 主要用于定义优先级,在app 中预定义几个优先级:
- 重要(1)
- 一般(2)等
查询的时候,传入priority 进行筛选;
注意:
2. 更新一个 Todo
https://www.wanandroid.com/lg/todo/update/83/json
方法:POST
参数:
id: 拼接在链接上,为唯一标识,列表数据返回时,每个todo 都会有个id标识 (必须)
title: 更新标题 (必须)
content: 新增详情(必须)
date: 2018-08-01(必须)
status: 0 // 0为未完成,1为完成
type: ;
priority: ;
如果有当前状态没有携带,会被默认值更新,比如当前 todo status=1,更新时没有带上,会认为被重置。
注意:当更新 status=1时,会自动设置服务器当前时间为完成时间。
3. 删除一个 Todo
https://www.wanandroid.com/lg/todo/delete/83/json
方法:POST
参数:
id: 拼接在链接上,为唯一标识
4. 仅更新完成状态Todo
https://www.wanandroid.com/lg/todo/done/80/json
方法:POST
参数:
id: 拼接在链接上,为唯一标识
status: 0或1,传1代表未完成到已完成,反之则反之。
只会变更status,未完成->已经完成 or 已经完成->未完成。
5. TODO 列表
https://www.wanandroid.com/lg/todo/v2/list/页码/json
页码从1开始,拼接在url 上
status 状态, 1-完成;0未完成; 默认全部展示;
type 创建时传入的类型, 默认全部展示
priority 创建时传入的优先级;默认全部展示
orderby 1:完成日期顺序;2.完成日期逆序;3.创建日期顺序;4.创建日期逆序(默认);
注意:page 从1开始
几个示例:
https://www.wanandroid.com/lg/todo/v2/list/1/json
所有的 TODO 按照创建的时间,倒序展示;
https://www.wanandroid.com/lg/todo/v2/list/1/json?status=0
未完成的 TODO 按照创建的时间,倒序展示;
https://www.wanandroid.com/lg/todo/v2/list/1/json?status=1&orderby=2
以完成的 TODO 按照完成的时间,倒序展示;
传入type 可以筛选特定type 下的。
传入priority 可以筛选某个特定优先级priority下的。