主题
接口总览
这一节用通俗的方式解释"接口"是什么,以及 Mall 系统的接口是怎么组织的。
什么是"接口"
你可以把接口理解为前台/后台和后端之间的沟通通道。
举个例子:
- 用户在前台点击"加入购物车" → 前端通过这个通道告诉后端"把这件商品放到这个用户的购物车里"
- 后端处理完后,通过同一个通道回复"好的,已经加进去了"
这个沟通通道就是接口(API)。
Mall 系统的接口分两大块
Mall 有两个独立的服务,各自有自己的接口:
┌─────────────────┐ ┌─────────────────┐
│ 前台商城 │ │ 后台管理 │
│ (消费者看到的) │ │ (运营团队用的) │
│ │ │ │
│ 端口: 8085 │ │ 端口: 8080 │
│ │ │ │
│ 接口前缀: │ │ 接口前缀: │
│ /api/... │ │ /api/... │
│ /member/... │ │ │
└────────┬─────────┘ └────────┬─────────┘
│ │
↓ ↓
┌─────────────────────────────────────────────────────────┐
│ 数据库(共享) │
│ MySQL + Redis + MongoDB │
└─────────────────────────────────────────────────────────┘| 服务 | 面向谁 | 主要功能 |
|---|---|---|
| 前台商城服务 | 消费者 | 浏览商品、搜索、购物车、下单、支付、售后、个人中心 |
| 后台管理服务 | 运营团队 | 商品管理、订单处理、促销配置、会员管理、权限控制 |
接口怎么认证(验证身份)
不是所有接口都需要登录。系统区分了两种情况:
| 类型 | 说明 | 举例 |
|---|---|---|
| 公开接口 | 不需要登录就能访问 | 首页数据、商品列表、搜索、商品详情 |
| 需认证接口 | 必须登录后才能访问 | 购物车、下单、收藏、个人信息 |
登录后的"身份凭证"(Token)会自动附在每次请求中,不需要用户手动操作。
接口文档怎么看
接下来的两篇文档,按业务功能组织(不是按技术结构),方便你理解每个功能背后调用了什么接口: