登录

去注册

登录

注册

去登录

注册

玩 Android TODO Open API v2

xiaoyang   2018-12-01   收藏

之前的 TODO API 存在一些问题,目前根据大家的反馈,对 TODO 列表增加了更多的可定制的 API。

TODO 因为要区分用户,所以必须在登录的情况下才能访问。

你可以在这里网页版新增几个 todo。

强烈建议先体验网页版 TODO。

然后可以直接访问列表查看大致的数据。

如果你需要制作app,需要参考本站所有open api中的登录部分。

强烈建议,所有的接口通过postman 调试清楚后再写app:

Postman 模拟带 cookie 的请求该文章,用户账号密码是明文,用于测试的,在线上环境会被加密传输。

可参考的开源 TODO app:

1. 新增一个 TODO

http://www.wanandroid.com/lg/todo/add/json

方法:POST
参数:
	title: 新增标题(必须)
	content: 新增详情(必须)
	date: 2018-08-01 预定完成时间(不传默认当天,建议传)
	type: 大于0的整数(可选);
	priority 大于0的整数(可选);
	

type 可以用于,在app 中预定义几个类别:例如 工作1;生活2;娱乐3;新增的时候传入0,1,2,查询的时候,传入type 进行筛选;

priority 主要用于定义优先级,在app 中预定义几个优先级:重要(1),一般(2)等,查询的时候,传入priority 进行筛选;

2. 更新一个 Todo

http://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,更新时没有带上,会认为被重置。

3. 删除一个 Todo

http://www.wanandroid.com/lg/todo/delete/83/json

方法:POST
参数:
	id: 拼接在链接上,为唯一标识

4. 仅更新完成状态Todo

http://www.wanandroid.com/lg/todo/done/80/json

方法:POST
参数:
	id: 拼接在链接上,为唯一标识
	status: 0或1,传1代表未完成到已完成,反之则反之。

只会变更status,未完成->已经完成 or 已经完成->未完成。

5. TODO 列表

http://www.wanandroid.com/lg/todo/v2/list/页码/json
	页码从1开始,拼接在url 上
	status 状态, 1-完成;0未完成; 默认全部展示;
	type 创建时传入的类型, 默认全部展示
	priority 创建时传入的优先级;默认全部展示
	orderby 1:完成日期顺序;2.完成日期逆序;3.创建日期顺序;4.创建日期逆序(默认);

注意:page 从1开始

几个示例:

http://www.wanandroid.com/lg/todo/v2/list/1/json

所有的 TODO 按照创建的时间,倒序展示;

http://www.wanandroid.com/lg/todo/v2/list/1/json?status=0

未完成的 TODO 按照创建的时间,倒序展示;

http://www.wanandroid.com/lg/todo/v2/list/1/json?status=1&orderby=2

以完成的 TODO 按照完成的时间,倒序展示;

传入type 可以筛选特定type 下的。

传入priority 可以筛选某个特定优先级priority下的。