Skip to content

接口总览

这一节用通俗的方式解释"接口"是什么,以及 Mall 系统的接口是怎么组织的。


什么是"接口"

你可以把接口理解为前台/后台和后端之间的沟通通道

举个例子:

  • 用户在前台点击"加入购物车" → 前端通过这个通道告诉后端"把这件商品放到这个用户的购物车里"
  • 后端处理完后,通过同一个通道回复"好的,已经加进去了"

这个沟通通道就是接口(API)。

Mall 系统的接口分两大块

Mall 有两个独立的服务,各自有自己的接口:

┌─────────────────┐                    ┌─────────────────┐
│   前台商城       │                    │   后台管理       │
│  (消费者看到的)   │                    │  (运营团队用的)   │
│                  │                    │                  │
│  端口: 8085      │                    │  端口: 8080      │
│                  │                    │                  │
│  接口前缀:       │                    │  接口前缀:       │
│  /api/...        │                    │  /api/...        │
│  /member/...     │                    │                  │
└────────┬─────────┘                    └────────┬─────────┘
         │                                       │
         ↓                                       ↓
┌─────────────────────────────────────────────────────────┐
│                    数据库(共享)                         │
│              MySQL + Redis + MongoDB                     │
└─────────────────────────────────────────────────────────┘
服务面向谁主要功能
前台商城服务消费者浏览商品、搜索、购物车、下单、支付、售后、个人中心
后台管理服务运营团队商品管理、订单处理、促销配置、会员管理、权限控制

接口怎么认证(验证身份)

不是所有接口都需要登录。系统区分了两种情况:

类型说明举例
公开接口不需要登录就能访问首页数据、商品列表、搜索、商品详情
需认证接口必须登录后才能访问购物车、下单、收藏、个人信息

登录后的"身份凭证"(Token)会自动附在每次请求中,不需要用户手动操作。

接口文档怎么看

接下来的两篇文档,按业务功能组织(不是按技术结构),方便你理解每个功能背后调用了什么接口:

  • 前台接口 — 消费者端的所有接口,按购物流程组织
  • 后台接口 — 运营端的所有接口,按管理模块组织

技术细节

如果你需要查看接口的完整技术规格(请求参数、响应结构、字段定义),请参阅:

Mall 电商系统知识库