基于swift4.2和Vapor3的服务端开源项目

Slice 3.png
这是基于 Swift 4.2 和 Vapor 3 框架的 Swift 服务端开源项目。
Vapor是一个服务器端开发框架，专为Swift编写而设计。
Vapor 3基于Apple的Swift NIO构建，通过其非阻塞架构提供令人难以置信的高性能，其面向协议的设计使其易于学习。

目前此开源项目已部署在cclion.cc （ubuntu 16.04）。
大家可以在GitHub查看代码，持续更新。

查看

本项目包括以下内容：

• 登录、注册、获取个人信息、退出功能；
• 发布文章、获取个人文章列表
• 上传图片、获取图片

用户相关

• 注册
• 登录
• 获取个人信息
• 退出登录

文章

• 发布文章
• 获取个人文章列表

图片

• 上传图片
• 获取图片

用户

用户相关接口包括登录、注册、获取个人信息、退出登录。

注册

oauth/regist

请求方式：POST

请求参数

参数	必选	类型	说明
phone	是	string	账号
password	是	string	密码

返回字段

返回字段	字段类型	说明
code	int	0 = 验证成功
message	string	描述字段
data	string	登录成功返回 Token

返回示例

{
    "status": 0,
    "message": "验证成功",
    "data": {
        "expiryTime": "2018-12-20T10:51:32Z",
        "token": "nmEtM5vh8RUAcBdbc5IS8tlzFRACSpI6HoNggEjoLIw"
    }
}

登录

oauth/login

请求方式：POST

请求参数

参数	必选	类型	说明
phone	是	string	账号
password	是	string	密码

返回字段

返回字段	字段类型	说明
code	int	0 = 请求成功
message	string	描述字段
data	string	注册成功则返回 Token

返回示例

{
    "status": 0,
    "message": "注册成功",
    "data": {
        "expiryTime": "2018-12-20T10:51:32Z",
        "token": "nmEtM5vh8RUAcBdbc5IS8tlzFRACSpI6HoNggEjoLIw"
    }
}

获取用户个人信息

oauth/getUserInfo

请求方式：POST

请求参数

无

返回字段

返回字段	字段类型	说明
code	int	0 = 验证成功
message	string	描述字段
phone	string	注册手机号

返回示例

{
    "status": 0,
    "message": "注册成功",
    "data": {
        "phone": "13188888885"
    }
}

退出登录

oauth/exit

请求方式：POST

请求参数

无

返回字段

返回字段	字段类型	说明
code	int	0 = 验证成功
message	string	描述字段

返回示例

{
    "status": 0,
    "message": "注册成功"
}

文章

文章相关接口包括上传文章、获取个人文章列表。

上传文章

article/addArticle

请求方式：POST

请求参数

参数	必选	类型	说明
title	是	string	标题
content	是	string	文本内容
image	否	string	图片地址

返回字段

返回字段	字段类型	说明
code	int	0 = 成功
message	string	添加成功

返回示例

{
    "status": 0,
    "message": "添加成功"
}

获取个人文章列表

article/getArticles

请求方式：POST

请求参数

无

返回字段

返回字段	字段类型	说明
id	int	文章id
title	string	文章标题
content	string	文章内容
image	string	图片内容
userID	int	用户ID

返回示例

{
    "status": 0,
    "message": "添加成功",
    "data": [
         {
          "id": 1,
          "title": "title",
          "content": "这是文本",
          "userID": 7
        },
        {
          "id": 2,
          "title": "title",
          "content": "这是文本",
          "userID": 7
        }
    ]
}

图片

图片相关接口包括上传图片、获取图片。

上传图片

image/updateImage

请求方式：POST

请求参数

参数	必选	类型	说明
image	是	File	图片文件

返回字段

返回字段	字段类型	说明
code	int	0 = 成功
message	string	添加成功
imageStr	string	图片地址绝对路径

返回示例

{
    "status": 0,
    "message": "添加成功"
}

获取图片

image/imageStr

请求方式：Get

请求参数

参数	必选	类型	说明
/	是	string	图片地址

返回字段

返回字段	字段类型	说明
/	File	图片文件

返回示例

    我是一张图片