Wie man in 30 Minuten eine REST API in JavaScript schreibt: Ein praktischer Leitfaden

Einleitung: Warum Sie eine REST API in JavaScript in 30 Minuten brauchen?

Moderne Webentwicklung ist ohne API (Application Programming Interface) undenkbar. REST (Representational State Transfer) ist der beliebteste Architekturstil für die Erstellung von Webdiensten. Wenn Sie schnell die Backend-Entwicklung erlernen oder Ihren ersten Server starten möchten, sind JavaScript und Node.js die ideale Wahl. In 30 Minuten können Sie eine vollwertige REST API erstellen, die Anfragen verarbeitet, Daten im JSON-Format zurückgibt und mit einer Datenbank arbeitet (in unserem Beispiel mit einem einfachen Array im Arbeitsspeicher).

In diesem Artikel analysieren wir ein praktisches Beispiel: Wir erstellen eine API zur Verwaltung einer Aufgabenliste (To-Do-Liste). Sie lernen, wie Sie einen Server konfigurieren, GET-, POST-, PUT- und DELETE-Anfragen verarbeiten und eine grundlegende Validierung hinzufügen. Am Ende der Lektüre haben Sie einen fertigen Code, den Sie sofort ausführen und testen können.

Schritt 1: Projekteinrichtung und Installation der Abhängigkeiten

Bevor Sie Code schreiben, müssen Sie die Umgebung vorbereiten. Stellen Sie sicher, dass Node.js installiert ist (Download von der offiziellen Website). Befolgen Sie dann die Anleitung:

\n
1. Erstellen Sie einen neuen Ordner für das Projekt, z.B. rest-api-todo.
\n
2. Öffnen Sie das Terminal in diesem Ordner und führen Sie den Befehl npm init -y aus – dies erstellt die Datei package.json.
\n
3. Installieren Sie Express – das beliebteste Framework für Node.js: npm install express.
\n
4. Installieren Sie zur Vereinfachung nodemon als dev-Abhängigkeit: npm install --save-dev nodemon. Es startet den Server bei Codeänderungen automatisch neu.
\n

Fügen Sie nach der Installation in package.json ein Skript zum Starten hinzu:

"scripts": {\n  "start": "node index.js",\n  "dev": "nodemon index.js"\n}

Schritt 2: Erstellung eines grundlegenden Servers mit Express

Jetzt erstellen wir die Datei index.js – dies wird der Einstiegspunkt unserer Anwendung sein. Darin konfigurieren wir den Server, binden Middleware für die Arbeit mit JSON ein und definieren die erste Route.

const express = require('express');\nconst app = express();\nconst PORT = 3000;\n\n// Middleware zum Parsen von JSON\napp.use(express.json());\n\n// Temporärer Datenspeicher (anstelle einer Datenbank)\nlet tasks = [\n    { id: 1, title: 'Express lernen', completed: false },\n    { id: 2, title: 'REST API schreiben', completed: false }\n];\nlet currentId = 3;\n\n// Basisroute zur Überprüfung\napp.get('/', (req, res) => {\n    res.send('REST API funktioniert! Verwenden Sie /api/tasks');\n});\n\n// Server starten\napp.listen(PORT, () => {\n    console.log(`Server gestartet unter http://localhost:${PORT}`);\n});

Starten Sie den Server mit dem Befehl npm run dev und öffnen Sie im Browser http://localhost:3000. Sie sollten die Meldung "REST API funktioniert!" sehen.

Schritt 3: Implementierung von CRUD-Operationen (GET, POST, PUT, DELETE)

Jetzt kommt der spannende Teil – wir erstellen eine vollwertige REST API zur Verwaltung von Aufgaben. Wir implementieren vier grundlegende HTTP-Methoden:

3.1. GET /api/tasks – Abrufen aller Aufgaben

// Alle Aufgaben abrufen\napp.get('/api/tasks', (req, res) => {\n    res.json(tasks);\n});

3.2. GET /api/tasks/:id – Abrufen einer einzelnen Aufgabe nach ID

// Aufgabe nach ID abrufen\napp.get('/api/tasks/:id', (req, res) => {\n    const id = parseInt(req.params.id);\n    const task = tasks.find(t => t.id === id);\n    \n    if (!task) {\n        return res.status(404).json({ message: 'Aufgabe nicht gefunden' });\n    }\n    res.json(task);\n});

3.3. POST /api/tasks – Erstellen einer neuen Aufgabe

// Neue Aufgabe erstellen\napp.post('/api/tasks', (req, res) => {\n    const { title, completed } = req.body;\n    \n    // Validierung\n    if (!title || typeof title !== 'string') {\n        return res.status(400).json({ message: 'Aufgabentitel ist erforderlich und muss ein String sein' });