当我刚开始学习后端开发时,创建 API 的想法让我感到畏惧。 我以为你需要庞大的服务器、复杂的数据库和大量的代码才能让它工作起来。
但后来我发现了 Node.js 和 Express,一切都改变了。
在这篇文章中,我将向您展示如何使用 Node.js 和 Express 逐步构建我的第一个简单 API,无需复杂的设置,只需清晰实用的学习。
你需要什么
在我们开始之前,请确保您已:
您的计算机上安装了 Node.js
像 VS Code 这样的代码编辑器
对 JavaScript 有基本的了解
要检查 Node.js 是否已安装,请打开终端并运行:
node -v
如果您看到版本号,就可以开始了!
步骤 1:设置项目
首先,为您的项目创建一个新文件夹:
mkdir simple-api cd simple-api 然后使用 npm 初始化它:
npm init -y 这将创建一个包含您的项目信息的 package.json 文件。
第 2 步:安装 Express
Express 是一个轻量级的 Node.js 框架,可以非常轻松地构建 API。
使用以下命令安装:
npm install express 安装后,创建一个名为 server.js(或 index.js)的新文件。
步骤3:创建基本服务器
现在打开你的文件并写入以下代码:
const express = require('express'); const app = express(); const PORT = 5000;
app.get('/', (req, res) => { res.send('Welcome to my first API!'); });
app.listen(PORT, () => { console.log(`Server running on });
以下是正在发生的事情:
我们进口快递。
创建一个应用程序实例。
定义主页的路线(/)。
在端口 5000 上启动服务器。
运行服务器:
node server.js
。 你应该看到:
“欢迎使用我的第一个 API!”
🎉 恭喜!您刚刚创建了第一个可用的 API 端点
*步骤 4:添加更多路由 * 让我们让它更实用一些。 添加一条返回用户列表的路由:
const users = [ { id: 1, name: 'John Doe' }, { id: 2, name: 'Jane Smith' }, { id: 3, name: 'Mike Johnson' } ];
app.get('/api/users', (req, res) => { res.json(users); }); 时 ,您将看到:
[ { "id": 1, "name": "John Doe" }, { "id": 2, "name": "Jane Smith" }, { "id": 3, "name": "Mike Johnson" } ]
轰隆隆💥——您已经拥有一个可用的 JSON API。
Step 5: Handling POST Requests 有时您需要向 API 发送数据(例如添加新用户)。 为此,我们将使用 POST 请求。
首先,告诉 Express 使用 JSON:
app.use(express.json()); 然后创建一个 POST 路由:
app.post('/api/users', (req, res) => { const newUser = req.body; users.push(newUser); res.status(201).json(newUser); }); 现在您可以使用 Postman 或 cURL 等工具发送 POST 请求,它会将新用户添加到数组中。
步骤 6:使用路由参数
我们还可以通过 ID 获取单个用户:
app.get('/api/users/:id', (req, res) => { const user = users.find(u => u.id === parseInt(req.params.id)); if (!user) return res.status(404).send('User not found'); res.json(user); });
访问 — 您将获得:
{ "id": 1, "name": "John Doe" }
步骤7:收尾工作
到目前为止,您的 API 可以:
返回所有用户
添加新用户
- Return a single user by ID 您刚刚构建了一个功能性 REST API — 无需框架,无需复杂性。
这是您的完整代码:
const express = require('express'); const app = express(); const PORT = 5000;
app.use(express.json());
const users = [ { id: 1, name: 'John Doe' }, { id: 2, name: 'Jane Smith' }, { id: 3, name: 'Mike Johnson' } ];
app.get('/', (req, res) => { res.send('Welcome to my first API!'); });
app.get('/api/users', (req, res) => { res.json(users); });
app.get('/api/users/:id', (req, res) => { const user = users.find(u => u.id === parseInt(req.params.id)); if (!user) return res.status(404).send('User not found'); res.json(user); });
app.post('/api/users', (req, res) => { const newUser = req.body; users.push(newUser); res.status(201).json(newUser); });
app.listen(PORT, () => {
console.log(Server running on :${PORT});
});
使用 Node.js 和 Express 构建 API 是开始学习后端开发的最佳方法之一。 它教你如何使用 JavaScript 实现服务器、路由和 HTTP 方法的运行。
一旦您对此感到满意,您可以通过以下方式进行更深入的了解:
将您的 API 连接到真实数据库(MongoDB 或 PostgreSQL)
使用 JWT 添加身份验证
部署到 Render 或 Vercel 等平台
如果您想逐步学习 Web 开发和后端技能, ,我会在那里分享有关 Web 开发、Next.js 和加密交易的适合初学者的指南。作者www.mjsyxx.com