blog 文档

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样式

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容