青衿市集后端 API 文档

Spring Boot 后端服务 · 用户端与管理端接口入口 · Base URL: https://qjbe.deceric.site

服务状态

用于确认后端容器、Nginx 反向代理和数据库连接是否正常。

健康检查 分类接口

接口契约

接口请求体、响应字段和错误码以 Apifox 文档为准，后端实现按契约对齐。

Apifox 项目

鉴权规则

登录成功后将 token 放入请求头：Authorization: Bearer {token}。

查看鉴权接口

快速验证

用途命令
健康检查 curl https://qjbe.deceric.site/api/health
分类列表 curl https://qjbe.deceric.site/api/categories
用户登录 curl -X POST https://qjbe.deceric.site/api/users/login -H "Content-Type: application/json" -d '{"identifier":"1120235622","password":"******","remember_me":false}'

说明：此页面只作为后端接口入口说明；完整字段、示例和断言仍以 Apifox 为准。

用户与鉴权接口

方法路径说明鉴权
POST/api/users/email-code发送注册邮箱验证码否
POST/api/users/register用户注册否
POST/api/users/login用户登录并返回 token否
POST/api/users/logout退出登录是
GET/api/users/me获取当前用户信息是
PUT/api/users/me修改个人资料是
POST/api/users/password/reset-code发送重置密码验证码否
PUT/api/users/password/reset提交新密码完成重置否

认证、上传与商品接口

方法路径说明鉴权
GET/api/users/me/auth获取当前认证状态详情是
POST/api/users/me/auth提交或更新认证申请是
POST/api/upload上传头像、商品图或认证材料是
GET/api/upload/{file_id}访问 private 文件是
DELETE/api/upload/{file_id}删除未绑定文件是
GET/api/categories获取商品分类列表否
GET/api/goods获取商品列表否
POST/api/goods发布新商品是，需已认证
GET/api/goods/{goods_id}获取商品详情可选
PUT/api/goods/{goods_id}编辑商品是，卖家本人
DELETE/api/goods/{goods_id}删除商品是，卖家本人

沟通、订单与评价接口

方法路径说明鉴权
GET/api/goods/{goods_id}/messages获取商品公开留言列表否
POST/api/goods/{goods_id}/messages发表公开留言是
GET/api/conversations获取我的私信会话列表是
POST/api/conversations创建或复用私信会话是
GET/api/conversations/{conversation_id}/messages获取会话消息，支持 after_message_id是
POST/api/orders创建订单是，需已认证
GET/api/orders/{order_id}获取订单详情是，买卖双方
PUT/api/orders/{order_id}/confirm卖家确认接单是，卖家
PUT/api/orders/{order_id}/complete买家确认交易完成是，买家
GET/api/orders/{order_id}/reviews查看订单评价详情是，买卖双方
POST/api/orders/{order_id}/reviews提交评价是，买卖双方

管理端接口

方法路径说明鉴权
POST/api/admin/login管理员登录否
GET/api/admin/dashboard后台统计管理员
GET/api/admin/goods商品审核列表管理员
PUT/api/admin/goods/{goods_id}/approve商品审核通过管理员
PUT/api/admin/goods/{goods_id}/reject商品驳回管理员
GET/api/admin/auth-applications认证申请列表管理员
PUT/api/admin/auth-applications/{user_id}/approve认证通过管理员
GET/api/admin/users用户列表管理员
GET/api/admin/orders订单列表管理员

管理端接口较多，此处列出主要入口；完整参数和响应结构以管理端 OpenAPI / Apifox 文档为准。