Einleitung: REST API in einer halben Stunde – das ist machbar
REST API ist die Grundlage moderner Web-Interaktion. Ob Sie ein Frontend-Entwickler sind, der das Backend verstehen möchte, oder ein Anfänger, der schnell seinen ersten Server erstellen will – dieser Leitfaden ist für Sie. Wir werden Schritt für Schritt durchgehen, wie Sie buchstäblich in 30 Minuten eine vollwertige REST API in JavaScript (Node.js) schreiben.
Wir verwenden einen minimalen Stack: Node.js und Express.js – das beliebteste Framework zur Erstellung von APIs. Kein überflüssiger Code, nur Praxis. Am Ende des Artikels haben Sie einen funktionierenden Server mit CRUD-Operationen (Erstellen, Lesen, Aktualisieren, Löschen).
Schritt 1: Vorbereitung und Installation der Abhängigkeiten
Stellen Sie zunächst sicher, dass Node.js (Version 14 oder höher) auf Ihrem System installiert ist. Sie können es von der offiziellen Website herunterladen. Überprüfen Sie die Installation:
node -vnpm -vErstellen Sie einen Projektordner und wechseln Sie hinein:
mkdir my-rest-apicd my-rest-apiInitialisieren Sie das Projekt und installieren Sie Express:
npm init -ynpm install expressDer Einfachheit halber installieren wir nodemon – es startet den Server automatisch neu, wenn sich der Code ändert:
npm install --save-dev nodemonÖffnen Sie nun die package.json und ersetzen Sie den Abschnitt "scripts" durch:
"scripts": { "start": "node index.js", "dev": "nodemon index.js"}Großartig! Alles ist bereit zum Schreiben des Codes.
Schritt 2: Grundlegenden Server und ersten Endpunkt schreiben
Erstellen Sie eine Datei index.js im Stammverzeichnis des Projekts. Beginnen wir mit dem Import von Express und der Konfiguration des Ports:
const express = require('express');const app = express();const PORT = 3000;
// Middleware zum Parsen von JSONapp.use(express.json());
// Einfacher Test-Endpunktapp.get('/', (req, res) => { res.send('Meine REST API funktioniert!');});
// Server startenapp.listen(PORT, () => { console.log(`Server läuft auf http://localhost:${PORT}`);});Starten Sie den Server mit dem Befehl:
npm run devGehen Sie in Ihrem Browser zu http://localhost:3000 – Sie sollten die Nachricht "Meine REST API funktioniert!" sehen.
Datenbank-Simulation hinzufügen
Der Einfachheit halber speichern wir die Daten im Arbeitsspeicher (Array). In einem echten Projekt würden Sie MongoDB oder PostgreSQL verwenden, aber für Lernzwecke reicht das aus.
// Datenbank-Simulationlet users = [ { id: 1, name: 'Alexei', email: 'alex@example.com' }, { id: 2, name: 'Maria', email: 'maria@example.com' }];let nextId = 3;Schritt 3: Implementierung von CRUD-Operationen
Jetzt erstellen wir vollwertige Endpunkte für die Arbeit mit Benutzern. Wir implementieren die vier wichtigsten HTTP-Methoden: GET, POST, PUT, DELETE.
GET – Alle Benutzer abrufen
// Alle Benutzer abrufenapp.get('/api/users', (req, res) => { res.json(users);});
// Benutzer nach ID abrufenapp.get('/api/users/:id', (req, res) => { const id = parseInt(req.params.id); const user = users.find(u => u.id === id); if (!user) { return res.status(404).json({ message: 'Benutzer nicht gefunden' }); } res.json(user);});POST – Neuen Benutzer erstellen
// Benutzer erstellenapp.post('/api/users', (req, res) => { const { name, email } = req.body; // Einfache Validierung if (!name || !email) { return res.status(400).json({ message: 'Name und Email sind erforderlich' }); } const newUser = { id: nextId++, name, email }; users.push(newUser); res.status(201).json(newUser);});PUT – Benutzer aktualisieren
// Benutzer aktualisierenapp.put('/api/users/:id', (req, res) => { const id = parseInt(req.params.id); const { name, email } = req.body;```