登录

去注册

登录

注册

去登录

注册

解锁回答区域

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

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

解锁回答区域

又一个开放清单 API ,拿着 API 去玩耍吧...

maoruibin   2019-05-28 20:02   收藏

柳叶清单

list

柳叶清单是自己独立开发设计的一个 Web 清单应用,目前网页版已经上线运行,地址如下:

http://gudong.name/list

开发初衷:柳叶清单:管理日程的网页清单程序

于此同时,为了方便其他开发者使用清单服务,现在开放了部分 API,以便大家开发自己的 Todo 应用或者 demo 小程序

如果使用中有任何问题,也可以在 issue 中进行反馈。

关于作者

API model 关系说明

为了对清单 API 有更好的认识,这里先简单说一下具体的数据 model 关系,目前一共有 4 个 model,分别是 User、Project、Group、Todo.

  • User: 用户信息
  • Project:清单项目,一个用户(User)可以创建多个清单项目。
  • Group:分组,一个清单项目(Project)包含多个清单分组
  • Todo:事项,每个分组(Group)下有若干 Todo 组成

这个关系用图表示出来如下所示:

上面的示意有点抽象,这里用一个具体的例子进行展示如下:

下面是目前开放出来的所有数据操作相关的 API,包括用户登录、注册,以及事项(Todo)、分组(Group)、项目(Project)数据的操作,如下所示:


用户信息

登录

https://waishuo.leanapp.cn/api/v1.0/users/login

请求方式:POST

请求参数:

响应结果:

注册

https://waishuo.leanapp.cn/api/v1.0/users/register

请求方式:POST

请求参数:

响应结果:

获取用户信息

https://waishuo.leanapp.cn/api/v1.0/users/<userId>

请求方式:GET

说明:url 请求参数中最后需要指定 user id

请求参数:

响应结果:


Todo

创建 todo

https://waishuo.leanapp.cn/api/v1.0/todos

请求方式:POST

请求参数:

响应结果:

更新 Todo

https://waishuo.leanapp.cn/api/v1.0/todos/<todoId>

请求方式:PUT

说明:url 请求参数中最后需要指定 todo id

请求参数:

响应结果:

删除 Todo

https://waishuo.leanapp.cn/api/v1.0/todos/<todoId>

请求方式:DEL

请求参数:

说明:url 请求参数中最后需要指定 todo id

响应结果:

获取 Todo

https://waishuo.leanapp.cn/api/v1.0/todos/<todoId>

请求方式:GET

请求参数:

说明:url 请求参数中最后需要指定 todo id

响应结果:


分组 API

创建分组

https://waishuo.leanapp.cn/api/v1.0/groups

请求方式:POST

请求参数:

响应结果:

更新分组

https://waishuo.leanapp.cn/api/v1.0/groups/<groupId>

请求方式:PUT

说明:url 请求参数中最后需要指定 groupId

请求参数:

响应结果:

获取项目分组列表

https://waishuo.leanapp.cn/api/v1.0/groups/projects/<projectId>

请求方式:GET

请求参数:

说明:url 请求参数中最后需要指定 projectId

响应结果:

删除分组

https://waishuo.leanapp.cn/api/v1.0/groups/<groupId>

请求方式:DEL

请求参数:

说明:url 请求参数中最后需要指定 groupId

响应结果:


Project 相关 api

创建项目

https://waishuo.leanapp.cn/api/v1.0/project

请求方式:POST

请求参数:

响应结果:

编辑项目

https://waishuo.leanapp.cn/api/v1.0/project

请求方式:PUT

请求参数:

响应结果:

删除项目

https://waishuo.leanapp.cn/api/v1.0/projects/<projectId>

注意:删除时,会把项目下的分组以及 todo 全部删除

请求方式:DEL

说明:url 请求参数中最后需要指定 projectId

项目地址:https://github.com/maoruibin/liuye