verification_code 验证码 varchar博客一阶段
1.1API 接口文档
接口基准地址:http://192.168.43.225/
数据返回格式统一使用JSON(如有其它格式将在接口文档声明)
1.1.1.支持的请求方法
POST
GET
1.1.2.通用返回状态码说明
状态码含义说明
200OK请求成功
404NOT FOUND请求的资源不存在
500INTERNAL SERVER ERROR内部服务端错误
1.2.数据库设计
数据库名称:blog
数据库账号:root
数据库密码:root
数据库格式::utf8 排序规则 :utf8_general_ci
1.2.1用户表(users)(1)
字段名含义数据类型长度说明
id用户id(唯一)varchar100必填
username用户名varchar50必填、客户端和服务端验证长度不超过12
password密码varchar50必填、客户端和服务端验证长度8-16且需要大小英文写加数字组合
head_portrait头像缩略图varchar数据库有默认值(存的是图片的地址pulick下面的head_portrait)
mailbox邮箱varchar50必填
tel手机号bigint
sex性别tinyint
Interest_tag兴趣标签varchar必填
createtime用户创建时间datetimeCURRENT_TIMESTAMP(数据库默认值)
user_type类型:3(1管理员 、2用户)int必填(如果时间不足就不做权限)
user_level用户等级int默认为0(可以不要)
user_collect用户收藏varchar
user_attention用户关注varchar
注:Interest_tag注册登录完了之后 系统根据标签为他匹配对应的内容
以下所有所及到当前用户的数据 除用户id以外 全部存在req.headers.user中
1.2.2博客表(article)(1)
字段名含义数据类型长度说明
a_id博客idvarchar100必填
a_title博客标题varchar50必填、两端验证长度不超过20
a_content博客内容mediumtext必填
a_img博客插图varchar50数据库有默认值(存的是图片的地址pulick下面的a_img)
a_type博客类别var50必填
a_createid创建者idvarchar必填
a_createtime博客创建时间datetimeCURRENT_TIMESTAMP(数据库默认值)
a_createname博客创建者名字varchar50必填
a_link博客链接varchar必填
注:a_type(如果时间不足就不做类别)类别有(html、css、js、node、vue、react 、其他)这个保留增删改接口;可以已经为专题
1.2.3博客交互表(blog_interactive)(1)
字段名含义数据类型长度说明
i_id交互表idvarchar博客id+序号数
a_id博客idvarchar100必填
a_createname博客创建者名字varchar必填
a_like_u点赞人varchar
a_comment_u评论者varchar
a_comment_c评论内容mediumtext
a_commentedid被回复者ID
a_commet_time评论时间datetimeCURRENT_TIMESTAMP(数据库默认值)
a_clicknum点击数int
遇到一个问题 如果这里只提供
注:当评论者为创建者是 显示为博主
1.2.4公告表(notice)(2)
字段名含义数据类型说明
n_id公告idvarchar必填
n_level公告级别int
n_createname公告创建者名字varchar
n_createid公告创建者idvarchar
title公告标题mediumtext必填
content公告内容mediumtext(可不使用)
createtime创建时间datetime必填
1.2.5私聊表单(chat)(2)
字段名含义数据类型说明
c_id条记录idvarchar必填
u_type发送发post/接受方getvarchar必填(post)
u_id当前用户idvarchar必填
u_name当前用户名字varchar必填
u_head_portrait当前用户头像varchar必填
o_type发送发post/接受方getvarchar必填
o_id对方idvarchar必填
c_content聊天内容varchar必填
c_createtime消息发送时间datetime必填
c_read是否已读tinyint默认0(0未读1已读)
系统默认头像表单(1)
字段名含义数据类型说明
h_num头像序号varchar必填
head_portrait头像位置必填
静态文件加下的 public/system/head_portrait
1.3 基础部分
关于产生global不能存放验证码这一说
1.3.0注册验证接口(1)
请求路径 :/users/register
请求方法:post
请求参数
多方式注册
参数名参数说明数据类型备注
username用户名varchar不能为空
password密码varchar不能为空
mailbox邮箱varchar绑定QQ邮箱
verification_code验证码varchar参数在后端形成(绑定qq邮箱时使用)
verification_code2验证码2varchar注册时候用
refresh_p刷新验证码var随机不重复参数
type用户类型varchar(1管理员 2用户 )
注:前端输入邮箱后点击确定后 后台保存(global或redis)并发送验证码到指定的qq邮箱中
注册的时候密码使用MD5加密
关于注册模式
响应参数
参数名参数说明数据类型备注
result成功或者失败varchar
1.3.1登录验证接口(1)
请求路径:/users/login
请求方法:post
请求参数
多方式登录
参数名参数说明数据类型备注
username用户名varchar不能为空
password密码varchar不能为空
verification_code验证码varcharsvg-captcha
type用户类型int(1管理员 2用户 )
响应参数(token、数据库默认头像表)
1.3.1.1 主页(1)
请求路径:/index
请求方法:get
请求参数:无
动态签名(适用于游客,防止非法请求,但不适合于H5前端显露源码的场景)
响应参数
即分页查找博客功能 条件为all(时间靠前的出)
字段名含义数据类型长度说明
a_id博客idvarchar50必填
a_title博客标题varchar必填、两端验证长度不超过20
a_content博客内容mediumtext必填
a_img博客插图varchar50数据库有默认值(存的是图片的地址pulick下面的a_img)
a_type博客类别var50必填
a_createid创建者idvarchar必填
a_createtime博客创建时间datetimeCURRENT_TIMESTAMP(数据库默认值)
a_createname博客创建者名字varchar必填
a_link博客链接varchar必填
1.3.1.2 登陆后的主业(1)
请求路径:/index
请求方法:post
请求token带入url中(这里建议使用服务端渲染技术 或者在初始化的时候进行token传输)
参数名参数说明备注
token令牌window.localstorage.token
响应参数(除密码以外的所有信息)
字段名含义数据类型长度说明
id用户id(唯一)varchar必填
username用户名varchar50必填、客户端和服务端验证长度不超过12
head_portrait头像缩略图varchar数据库有默认值(存的是图片的地址pulick下面的head_portrait).1.12
mailbox邮箱varchar50填
tel手机号bigint
sex性别tinyint
personal_profile
Interest_tag兴趣标签varchar必填
createtime用户创建时间datetimeCURRENT_TIMESTAMP(数据库默认值)
user_type类型:3(1管理员 、2用户)int必填(如果时间不足就不做权限)
user_level用户等级int默认为0(可以不要)
user_collect用户收藏varchar
user_attention用户关注varchar
字段名含义数据类型长度说明
a_id博客idvarchar50必填
a_title博客标题varchar必填、两端验证长度不超过20
a_content博客内容mediumtext必填
a_img博客插图varchar50数据库有默认值(存的是图片的地址pulick下面的a_img)
a_type博客类别var50必填
a_createid创建者idvarchar必填
a_createtime博客创建时间datetimeCURRENT_TIMESTAMP(数据库默认值)
a_createname博客创建者名字varchar必填
a_link博客链接varchar必填
1.3.2用户中心
1.3.2.1用户基本信息(1)
请求路径:/users/ baseinfo
请求方法:get
请求参数 :
参数名参数说明备注
token令牌window.localstorage.token
响应参数
参数名参数说明数据类型备注
username用户名varchar
head_portrait头像缩略图varchar
tel手机号varchar
sex性别tinyint
Interest_tag兴趣标签var
1.3.2.2用户账号信息(1)
请求路径:/users/ account
请求方法:post
请求参数 :
参数名参数说明备注
token令牌window.localstorage.token
响应参数
参数名参数说明数据类型备注
/users/ account/uppwd修改密码接口varchar
/users/ account/upphonenum修改手机号接口varchar
/users/ account/upemail修改邮箱接口varchar
1.3.2.2用户修改账号信息(1)
请求路径:/users/ account/uppwd、/users/ account/upphonenum、/users/ account/upemail
请求方法:post
请求参数 :
参数名参数说明备注
token令牌window.localstorage.token
uppwd更新后的密码
注: 手机号:手机验证码 ,邮箱:邮箱验证码
1.3.2.2用户修改头像(1)
请求路径:/users/upicon
请求方法:post
请求参数
参数名参数说明数据类型备注(都是必传)
token
head_portrai头像varchar修改用户头像连接
响应参数
参数名参数说明数据类型备注
results成功或者失败varchar上传结果
1.4 个人博客中心(2)
请求路径:/index/blog
请求方法:post
请求参数 :
字段名含义数据类型长度说明
token密令varchar
id用户id(唯一)varchar必填
token令牌window.localstorage.token
返回参数
字段名含义数据类型长度说明
username用户名varchar
blogs_num博客数量int
like_num获赞数int
user_level用户等级int默认为0(可以不要)
user_collect用户收藏varchar
token令牌window.localstorage.token
1.4 .1写博客(1)
请求路径:/users/blog/write
请求方法:post
请求参数 :
字段名含义数据类型长度说明
token令牌varcharwindow.localstorage.token
a_title博客标题varchar50必填、两端验证长度不超过20
a_content博客内容mediumtext必填
a_img博客插图varchar50数据库有默认值(存的是图片的地址pulick下面的a_img)
a_type博客类别var50必填
a_link博客链接varchar必填
在解令牌的时候 应该把用户存到个req.headers.user中
参数名参数说明数据类型备注
username用户名varchar
head_portrait头像缩略图varchar
a_createname博客创建者名字varchar
响应参数
参数名参数说明数据类型备注
results成功或者失败varchar
a_id博客idvarchar50
1.4 .1删博客(1)
请求路径:/index/blog/delete
请求方法:get
请求参数 :
字段名含义数据类型长度说明
token令牌varcharwindow.localstorage.token
a_id博客idvarchar50必填
响应参数
参数名参数说明数据类型备注
results成功或者失败varchar
1.4.2 发布通知(2)
请求路径:/admin/creatNotice
请求方法:post
请求参数
参数名参数说明数据类型备注
token令牌varchar
title标题text
content通知内容varchar
createtime创建时间datetime必填
响应参数
参数名参数说明数据类型备注
results成功或者失败varchar
1.4.2 私聊(2)
请求路径:/users/chat
请求方法:post
请求参数
参数名参数说明数据类型备注
token令牌varchar
c_id条记录idvarchar必填
u_id当前用户idvarchar必填
o_id对方idvarchar必填
c_content聊天内容varchar必填
c_createtime消息发送时间datetime必填
响应参数
参数名参数说明数据类型备注
results成功或者失败varchar
1.4.3未读转已读(2)
请求路径:/users/chatRead
请求方法:get
请求参数
参数名参数说明数据类型备注
token令牌varchar
c_id条记录idvarchar可以是一个数组[c_id1,c_id2]
c_read是否已读tinyint默认0(0未读1已读)
1.4.4. 我的消息(2)
1.4.4.1 通知
请求路径:/users/getNotice
请求方法:get
请求参数
参数名参数说明数据类型备注
token令牌varchar
n_level公告级别int
响应参数
字段名含义数据类型说明
n_id公告idint必填
n_level公告级别int
n_createname公告创建者名字varchar
n_createid公告创建者idvarchar
title公告标题mediumtext必填
content公告内容mediumtext(可不使用)
createtime创建时间datetime必填
1.4.4.2 查看私信(2)
请求路径:/users/getChat
请求方法:get
请求参数
参数名参数说明数据类型备注
token令牌varchar
响应参数
字段名含义数据类型说明
c_id条记录idvarchar必填
o_type发送发post/接受方getvarchar必填(get)
u_id当前用户idvarchar必填
u_name当前用户名字varchar必填
u_head_portrait当前用户头像varchar必填
c_content聊天内容varchar必填
c_createtime消息发送时间datetime必填
input file base64
// 关于切换css样式