Tyh2001 / tyh-weibo-v3

🧚🏻‍♀️ Vue3 + Element3 组合 api 微博项目开发，这是我的第一个使用 vite 创建的 vue3 的项目，使用全新组合 api 进行开发。（🧚🏻‍♀️ Vue3 + element3 combined API Weibo project development, this is my first vue3 project created by vite, which is developed using the new combined API.）

微博全栈开发

用户

接口地址

基础地址：http://localhost/Virgo_Tyh_PHP/public/index.php/

注册账号

基本信息

Path： index/User/Register

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/User/Register

返回 HTTP 状态码

1. 201 注册成功
2. 401 用户名已存在
3. 402 用户名信息不存在

请求参数

Body

名称	类型	是否必须	默认值	备注
username	string	必须		用户名
password	string	必须		密码
mail	string	必须		邮箱
captcha	string	必须		验证码
captchaCode	string	必须		验证码随机数

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息

登录

基本信息

Path： index/User/Login

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/User/Login

返回 HTTP 状态码

1. 201 登录成功
2. 401 用户信息不完善
3. 402 账号或密码错误

请求参数

Body

名称	类型	是否必须	默认值	备注
username	string	必须		用户名
password	string	必须		密码

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息
data	object	非必须		返回数据
├─ id	number	必须		用户 id
├─ nickname	string	必须		用户昵称
├─ photo	string	必须		用户头像

获取用户资料

基本信息

Path： index/User/getUserInfo

Method： GET

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/User/getUserInfo

返回 HTTP 状态码

1. 201 OK
2. 401 缺少参数

请求参数

Body

名称	类型	是否必须	默认值	备注
id	number	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息
data	object	非必须		返回数据
├─ avatar	number	必须		用户 id
├─ nickname	string	必须		用户昵称
├─ autograph	string	必须		个性签名
├─ gender	string	必须		性别
├─ feeling	string	必须		感情状况
├─ work	string	必须		职业
├─ city	string	必须		城市
├─ birthday	string	必须		生日
├─ mail	string	必须		邮箱
├─ regis_time	string	必须		注册时间
├─ follow_list	string	必须		关注数量
├─ fans_list	string	必须		粉丝数量

更新用户资料

基本信息

Path： index/User/changeUserInfo

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/User/changeUserInfo

返回 HTTP 状态码

1. 201 更新用户信息成功
2. 401 信息不完善

请求参数

Body

名称	类型	是否必须	默认值	备注
nickname	string	必须		昵称
autograph	string	必须		个性签名
gender	string	必须		性别
feeling	string	必须		感情状况
work	string	必须		职业
birthday	string	必须		生日
mail	string	必须		邮箱

Query

名称	类型	是否必须	默认值	备注
id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息

更新用户密码

基本信息

Path： index/User/changeUserPass

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/User/changeUserPass

返回 HTTP 状态码

1. 201 更新密码成功
2. 401 原始密码错误
3. 402 参数不完善

请求参数

Body

名称	类型	是否必须	默认值	备注
oldPass	string	必须		原始密码
newPass	string	必须		新密码

Query

名称	类型	是否必须	默认值	备注
id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息

更新用户头像

基本信息

Path： index/User/uploadPhoto

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/User/uploadPhoto

返回 HTTP 状态码

1. 201 更新头像成功
2. 401 更新失败

请求参数

Body

名称	类型	是否必须	默认值	备注
photo	file	必须		头像图片

Query

名称	类型	是否必须	默认值	备注
id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息
data	object	非必须		返回数据
├─ url	string	必须		更新后头像地址

博客

发布博客

基本信息

Path： index/Blog/releaseBlog

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Blog/releaseBlog

返回 HTTP 状态码

1. 201 发布成功

请求参数

Body

名称	类型	是否必须	默认值	备注
blogImages	formdata	非必须		博客图片内容

Query

名称	类型	是否必须	默认值	备注
blogText	string	必须		博客文字内容
userId	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息

获取全部博客

基本信息

Path： index/Blog/getAllBlogList

Method： GET

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Blog/getAllBlogList

返回 HTTP 状态码

1. 201 OK

请求参数

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息
data	object	非必须		数据
├─ nickname	string	必须		昵称
├─ blogId	string	必须		博客 id
├─ user_id	string	必须		用户 id
├─ avatar	string	必须		头像
├─ release_time	string	必须		发布时间
├─ text	string	必须		博客文字
├─ image	array	必须		博客图片

获取指定用户的博客

基本信息

Path： index/Blog/getUserBlogList

Method： GET

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Blog/getUserBlogList

返回 HTTP 状态码

1. 201 OK

请求参数

Query

名称	类型	是否必须	默认值	备注
id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息
data	object	非必须		数据
├─ blogId	string	必须		博客 id
├─ user_id	string	必须		用户 id
├─ nickname	string	必须		昵称
├─ avatar	string	必须		头像
├─ release_time	string	必须		发布时间
├─ text	string	必须		博客文字
├─ image	array	必须		博客图片

删除自己的指定博客内容

基本信息

Path： index/Blog/deleteMyBlog

Method： GET

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Blog/deleteMyBlog

返回 HTTP 状态码

1. 201 删除成功

请求参数

Query

名称	类型	是否必须	默认值	备注
blogId	string	必须		博客 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息

关注

关注指定用户

基本信息

Path： index/Follow/onFollowUser

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Follow/onFollowUser

返回 HTTP 状态码

1. 201 关注成功
2. 401 不能重复关注

请求参数

Body

名称	类型	是否必须	默认值	备注
follower_id	string	必须		被关注用户 id
user_id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息

取消关注指定用户

基本信息

Path： index/Follow/deleteFollowUser

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Follow/deleteFollowUser

返回 HTTP 状态码

1. 201 取消关注成功
2. 401 取消关注失败

请求参数

Body

名称	类型	是否必须	默认值	备注
follower_id	string	必须		被关注用户 id
user_id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息

获取我的关注列表

基本信息

Path： index/Follow/getFollowUserList

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Follow/getFollowUserList

返回 HTTP 状态码

1. 201 OK

请求参数

Body

名称	类型	是否必须	默认值	备注
user_id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息
data	array	必须		数据
├─ id	number	必须		序号
├─ user_id	number	必须		用户 id
├─ follower_id	number	必须		被关注用户的 id
├─ created_at	string	必须		关注时间
├─ user_nickname	string	必须		用户昵称
├─ user_avatar	string	必须		用户头像
├─ follower_nickname	string	必须		被关注用户昵称
├─ follower_avatar	string	必须		被关注用户头像

获取我的粉丝列表

基本信息

Path： index/Follow/getFansUserList

Method： POST

线上地址： http://localhost/Virgo_Tyh_PHP/public/index.php/index/Follow/getFansUserList

返回 HTTP 状态码

1. 201 OK

请求参数

Body

名称	类型	是否必须	默认值	备注
user_id	string	必须		用户 id

返回数据

名称	类型	是否必须	默认值	备注
code	number	必须		状态码
msg	string	必须		提示信息
data	array	必须		数据
├─ id	number	必须		序号
├─ user_id	number	必须		用户 id
├─ follower_id	number	必须		被关注用户的 id
├─ created_at	string	必须		关注时间
├─ user_nickname	string	必须		用户昵称
├─ user_avatar	string	必须		用户头像
├─ follower_nickname	string	必须		被关注用户昵称
├─ follower_avatar	string	必须		被关注用户头像