登录

去注册

登录

注册

去登录

  • 扫码关注公众号
  • 发送“我爱安卓
  • 即可获取验证码

注册

解锁回答区域

  • 扫码关注公众号
  • 发送“我爱安卓

若你登陆,将永久解锁;
若未登录,仅本机解锁。

解锁回答区域

获取注册验证码

  • 扫码关注公众号
  • 发送“我爱安卓
  • 即可获取验证码

玩 Android TODO Open API v2

xiaoyang   2018-12-01 16:29   收藏

务必使用 https:
务必使用 https:
务必使用 https:

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

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

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

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

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

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

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

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

可参考的开源 TODO app:

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下的。