Wie man in 30 Minuten eine REST API in JavaScript schreibt

Einführung: REST API in JavaScript — Schnell und Einfach

Moderne Webentwicklung ist ohne APIs nicht denkbar. REST (Representational State Transfer) ist der beliebteste Architekturstil für die Erstellung von Webdiensten. Wenn Sie schnell ein Backend für Ihre Anwendung erstellen oder die Grundlagen der serverseitigen Entwicklung erlernen möchten, sind Node.js und Express die ideale Wahl.

In diesem Artikel werden wir in 30 Minuten eine vollwertige REST API in JavaScript schreiben. Sie lernen, wie Sie einen Server einrichten, Routing organisieren, CRUD-Operationen (Create, Read, Update, Delete) implementieren und die API mit Postman testen. Keine unnötige Theorie — nur Praxis. Los geht's!

1. Umgebungseinrichtung und Abhängigkeitsinstallation

Stellen Sie vor dem Schreiben von Code sicher, dass Node.js (Version 14 oder höher) auf Ihrem Computer installiert ist. Sie können dies mit dem Befehl überprüfen:

node -vnpm -v

Erstellen Sie einen neuen Ordner für das Projekt und initialisieren Sie package.json:

mkdir my-rest-apicd my-rest-apinpm init -y

Jetzt installieren wir Express — ein minimales und flexibles Framework für Node.js. Installieren Sie auch body-parser zur Verarbeitung von JSON-Anfragen (in modernen Versionen von Express ist es integriert, aber zur Verdeutlichung fügen wir es explizit hinzu):

npm install express body-parser

Die Projektstruktur wird einfach sein:

• app.js — Hauptserverdatei
• routes/ — Ordner mit Routen
• data/ — Ordner mit Testdaten (Datenbanksimulation)

2. Erstellen eines Basisservers mit Express

Erstellen Sie eine Datei app.js und schreiben Sie den folgenden Code:

const express = require('express');const bodyParser = require('body-parser');const app = express();const PORT = 3000;

// Middleware zur Verarbeitung von JSONapp.use(bodyParser.json());

// Einfache Testrouterapp.get('/', (req, res) => {    res.send('REST API funktioniert!');});

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

Starten Sie den Server mit dem Befehl node app.js und öffnen Sie http://localhost:3000 in Ihrem Browser. Sie sollten die Nachricht "REST API funktioniert!" sehen. Herzlichen Glückwunsch, Sie haben gerade Ihren ersten Webserver auf Node.js erstellt!

Hinweis: body-parser wandelt eingehende Daten in das JSON-Format um, was für POST- und PUT-Anfragen erforderlich ist.

3. Organisieren von Routing und CRUD-Operationen

Jetzt fügen wir echte Daten hinzu. Erstellen Sie einen data-Ordner und darin eine Datei items.js mit einem Test-Array:

const items = [    { id: 1, name: 'Node.js lernen', completed: false },    { id: 2, name: 'API schreiben', completed: true },    { id: 3, name: 'Artikel veröffentlichen', completed: false }];

module.exports = items;

Erstellen Sie einen routes-Ordner und darin eine Datei items.js. Hier beschreiben wir alle Routen für die Arbeit mit Aufgaben (To-Do-Liste):

const express = require('express');const router = express.Router();let items = require('../data/items');

// GET /api/items — alle Elemente abrufenrouter.get('/', (req, res) => {    res.json(items);});

// GET /api/items/:id — Element nach ID abrufenrouter.get('/:id', (req, res) => {    const id = parseInt(req.params.id);    const item = items.find(i => i.id === id);    if (!item) return res.status(404).json({ message: 'Element nicht gefunden' });    res.json(item);});

// POST /api/items — ein neues Element erstellenrouter.post('/', (req, res) => {    const newItem = {        id: items.length + 1,        name: req.body.name,        completed: req.body.completed || false    };    items.push(newItem);    res.status(201).json(newItem);});

// PUT /api/items/:id — ein Element aktualisierenrouter.put('/:i