很多刚接触后端的朋友总觉得 API 设计很神秘,其实它就是你和前端约定好的一套对话规则。想象你在开一家餐馆,API 就是菜单,告诉客人能点什么菜、怎么点、会得到什么。今天咱们就从零开始,一步步搭建一个能用的后端服务。
先说 API 设计。最核心的是 RESTful 风格,简单讲就是用 HTTP 方法表达意图。GET 用来获取数据,POST 用来创建,PUT 用来更新,DELETE 用来删除。比如你要做一个用户管理系统,获取用户列表就用 GET /users,创建用户就用 POST /users,获取单个用户用 GET /users/1。这样设计的好处是任何人一看 URL 就知道要干什么,不需要额外解释。
代码层面,咱们用 Node.js 的 Express 框架来演示。先初始化项目,运行 npm init -y 创建 package.json,然后 npm install express 安装依赖。创建一个 index.js 文件,写上最基础的服务代码:引入 express,创建 app 实例,定义一个路由,监听端口。比如 app.get(‘/api/hello’, (req, res) => { res.json({ message: ‘Hello World’ }) }),这样访问 http://localhost:3000/api/hello 就能收到 JSON 响应。记得加上 app.listen(3000) 启动服务。
接口设计要注意数据格式统一。返回的数据最好包裹一层,包含 code、message、data 三个字段。code 是状态码,200 表示成功,400 表示参数错误,500 表示服务器错误。message 给人看的提示信息,data 才是真正的业务数据。这样前端处理起来非常统一,不会有时候收到数组有时候收到对象。
服务器配置是另一门学问。开发环境直接用 node index.js 就行,但生产环境必须用进程管理工具。推荐 PM2,安装后运行 pm2 start index.js –name my-api,它会自动守护进程,挂了自动重启。还要配置 Nginx 做反向代理,把 80 端口转发到你的 3000 端口。Nginx 配置文件里加上 location /api { proxy_pass http://127.0.0.1:3000; },这样用户访问你的域名就能直接调用接口。
数据库连接要放在环境变量里,不要写死在代码中。用 dotenv 包读取.env 文件,process.env.DB_HOST 这样获取配置。密码、密钥这些敏感信息永远不要提交到代码仓库。上线前记得加日志,用 winston 或 morgan 记录每次请求,出了问题好排查。
最后说部署。最简单的方案是买台云服务器,装上 Node.js 和 PM2,把代码 git clone 下来,npm install 安装依赖,pm2 启动服务。域名解析到服务器 IP,Nginx 配置好,HTTPS 证书用 Let’s Encrypt 免费申请。整套流程走下来,你的 API 就能对外提供服务了。
后端开发没有想象中那么难,关键是多动手。建个接口,调一调,看看返回什么,改一改,再看变化。遇到问题查文档、搜错误信息,大部分坑别人都踩过。慢慢积累,你也能设计出优雅可靠的 API 系统。