goapiserver

Go Demo API Server

• 项目介绍
• 项目操作
  • HTTP头部设置要求
  • 新增用户
  • 查询用户
  • 查询用户-分页
  • 修改用户
  • 删除用户
• 其他

项目介绍

为了更好了整合本人的技术栈，也为了能够帮助到大家学习go语言，尽快掌握go语言的工程实践。

我通过一个简单的业务demo，也就是用户信息的增删查改，来实现一个golang后端API应用。

主要涵盖了下面这些技术点：

• 路由
• 过滤器
• 日志
• 静态配置文件
• 控制器
• 模型
• redis缓存
• MySQL数据库
• 多国语言处理
• websocket服务
• 登录登出功能
• restful请求

以后可能会增加更多的技术内容进来，比如etcd, nsq等内容，也欢迎大家一起来完善本项目，造福更多的新人朋友。

请注意: websocket 不支持 6666 端口，请不要使用 6666 作为服务器的端口!!!

项目操作

HTTP头部设置要求

websocket 请求url

• 校验令牌，需要通过 url 传参的方式来传递

ws://127.0.0.1:7777/ws/hi?token=test

数据库表结构发生了变化，接口文档作废，待完善。。。

新增用户

• 方法和路由

POST 127.0.0.1:7777/test/api/v1/user

• 请求参数

• 请求参数demo

{
	"name": "test",
	"age": 18,
	"email": "test@163.com"
}

• 响应

• 响应demo

{
  "code": 0,
  "message": "用户添加成功!"
}

查询用户

• 方法和路由

GET 127.0.0.1:7777/test/api/v1/user?id=1

• 请求参数

• 响应

• 响应demo

{
  "id": 1,
  "name": "test",
  "age": 18,
  "email": "test@163.com"
}

查询用户-分页

• 方法和路由

GET 127.0.0.1:7777/test/api/v1/users?page_num=1&page_size=5

• 请求参数

• 响应

• 响应demo

{
  "total_num": 0,
  "list": null
}

修改用户

• 方法和路由

PUT 127.0.0.1:7777/test/api/v1/user

• 请求参数

• 请求参数demo

{
  "id": 1,
  "name": "fei",
  "age": 26
}

• 响应

• 响应demo

{
  "code": 0,
  "message": "用户更新成功!"
}

删除用户

• 方法和路由

DELETE 127.0.0.1:7777/test/api/v1/user

• 请求参数

• 请求参数demo

{
  "id": 1
}

• 响应

• 响应demo

{
  "code": 0,
  "message": "用户删除成功!"
}

其他

更多内容，陆续添加中，敬请期待。。。