Wie man in 30 Minuten eine REST API mit JavaScript schreibt

Einleitung: Warum REST API in JavaScript schnell und einfach ist

Die Erstellung einer eigenen REST API ist einer der ersten Schritte zum Verständnis der Backend-Entwicklung. Wenn Sie bereits mit JavaScript vertraut sind, können Sie den serverseitigen Teil einer Anwendung in buchstäblich einer halben Stunde schreiben. In diesem Artikel zeigen wir Ihnen, wie Sie eine REST API in JavaScript mit Node.js und dem Express-Framework schreiben. Wir erstellen eine einfache API zur Verwaltung einer To-Do-Liste mit Unterstützung für standardmäßige CRUD-Operationen: Erstellen, Lesen, Aktualisieren und Löschen von Daten.

Dieser Leitfaden ist perfekt für Anfänger, die schnell ihren ersten Server starten und verstehen möchten, wie Anfragen, Routen und Middleware funktionieren. Am Ende des Artikels haben Sie eine funktionierende API, die Sie in Postman oder einem Browser testen können.

Schritt 1: Einrichtung der Umgebung und Installation der Abhängigkeiten

Stellen Sie vor dem Schreiben von Code sicher, dass Node.js installiert ist (Version 16 oder höher). Falls nicht, laden Sie es von der offiziellen Website herunter. Zur Überprüfung führen Sie im Terminal aus:

node -vnpm -v

Erstellen Sie nun einen Ordner für das Projekt und initialisieren Sie es:

mkdir my-apicd my-apinpm init -y

Installieren Sie die Hauptabhängigkeit – das Express-Framework, das die Arbeit mit HTTP erheblich vereinfacht:

npm install express

Installieren Sie außerdem nodemon (optional) für den automatischen Neustart des Servers bei Codeänderungen:

npm install --save-dev nodemon

Fügen Sie ein Startskript in die Datei package.json ein:

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

Schritt 2: Erstellen eines grundlegenden Servers und der ersten Route

Erstellen Sie eine Datei index.js im Projektstammverzeichnis. Beginnen wir mit dem Einbinden von Express und dem Starten des Servers auf Port 3000:

const express = require('express');const app = express();const PORT = 3000;

// Middleware zum Parsen von JSONapp.use(express.json());

// Test-Routeapp.get('/', (req, res) => {  res.send('Hallo Welt! API funktioniert.');});

app.listen(PORT, () => {  console.log(`Server läuft unter http://localhost:${PORT}`);});

Starten Sie den Server mit dem Befehl npm run dev (bei Verwendung von nodemon) oder node index.js. Öffnen Sie Ihren Browser und gehen Sie zu http://localhost:3000 – Sie sollten die Meldung "Hallo Welt! API funktioniert." sehen.

Herzlichen Glückwunsch! Sie haben gerade eine REST API in JavaScript geschrieben. Fügen wir nun etwas echte Logik hinzu.

Schritt 3: Implementieren von CRUD-Operationen für eine Aufgabenliste

Erstellen wir einen temporären In-Memory-Datenspeicher (ein Array von Objekten). In einem echten Projekt würden Sie eine Datenbank anbinden, aber für eine 30-minütige Lektion ist dies ausreichend.

let tasks = [  { id: 1, title: 'Express lernen', completed: false },  { id: 2, title: 'API schreiben', completed: true }];

let nextId = 3;

Jetzt implementieren wir vier Haupt-Routen:

GET /tasks — Alle Aufgaben abrufen

app.get('/tasks', (req, res) => {  res.json(tasks);});

POST /tasks — Eine neue Aufgabe erstellen

app.post('/tasks', (req, res) => {  const { title } = req.body;  if (!title) {    return res.status(400).json({ error: 'Aufgabentitel ist erforderlich' });  }  const newTask = {    id: nextId++,    title,    completed: false  };  tasks.push(newTask);  res.status(201).json(newTask);});

PUT /tasks/:id — Eine Aufgabe aktualisieren

app.put('/tasks/:id', (req, res) => {  const id = parseInt(req.params.id);  const { title, completed } = req.body;  const task = tasks.find(t => t.id === id);  if (!task) {    return res.status(404).json({ error: 'Aufgabe nicht gefunden' });  }  if (title !== undefined) task.title = title;  if (completed !== undefined) task.completed = completed;  res.json(task);});

DELETE /tasks/:id — Eine Aufgabe löschen

app.delete('/tasks/:id', (req, res) => {  const id = parseInt(req.params.id);  const index = tasks.findIndex(t => t.id === id);  if (index === -1) {    return res.status(404).json({ error: 'Aufgabe nicht gefunden' });  }  tasks.splice(index, 1);  res.status(204).send();});

Schritt 4: Testen der API

Jetzt ist Ihre API bereit zum Testen. Sie können Postman, curl oder ein anderes Tool zum Senden von HTTP-Anfragen verwenden. Hier sind einige Beispiele:

// Alle Aufgaben abrufenGET http://localhost:3000/tasks

// Eine neue Aufgabe erstellenPOST http://localhost:3000/tasksContent-Type: application/json

{  "title": "API testen"}

// Eine Aufgabe aktualisierenPUT http://localhost:3000/tasks/1Content-Type: application/json

{  "completed": true}

// Eine Aufgabe löschenDELETE http://localhost:3000/tasks/2

Versuchen Sie, verschiedene Anfragen zu senden und beobachten Sie, wie der Server antwortet. Dies ist eine großartige Möglichkeit, um zu verstehen, wie eine REST API in der Praxis funktioniert.

Fazit: Was kommt als Nächstes?

Sie haben gerade in wenigen Minuten eine voll funktionsfähige REST API in JavaScript erstellt! Dies ist eine solide Grundlage für das weitere Lernen. Hier sind einige Ideen, was Sie als Nächstes hinzufügen können:

• Eine echte Datenbank anbinden (z. B. MongoDB mit Mongoose oder PostgreSQL mit Prisma)
• Datenvalidierung mit Bibliotheken wie Joi oder express-validator hinzufügen
• Benutzerauthentifizierung implementieren (JWT-Tokens)
• Paginierung und Sortierung für die Aufgabenliste hinzufügen
• Automatisierte Tests mit Jest oder Mocha schreiben

Jetzt wissen Sie, wie man eine REST API in JavaScript schreibt. Diese Fähigkeit wird Ihnen bei der Erstellung von Full-Stack-Anwendungen, Microservices und sogar bei der Automatisierung von Routineaufgaben nützlich sein. Viel Erfolg bei der Entwicklung!