🔌 API & REST

1. Was ist eine API?

API steht für Application Programming Interface (deutsch: Programmierschnittstelle). Eine API ist ein Vermittler, über den verschiedene Programme miteinander kommunizieren können.

🧩 Wofür werden APIs genutzt?

2. Wie funktioniert eine API?

Eine API funktioniert nach dem Client-Server-Prinzip:

📝 Eine einfache API-Anfrage

// Anfrage an eine Wetter-API
GET /api/wetter/berlin

// Antwort der API (JSON)
{
    "stadt": "Berlin",
    "temperatur": 22,
    "bedingung": "sonnig",
    "luftfeuchtigkeit": 65
}

3. Was ist REST?

REST (Representational State Transfer) ist ein Architektur-Stil für APIs. RESTful APIs sind der Standard im modernen Web.

📌 Die 6 Prinzipien von REST

• Client-Server: Trennung zwischen Client (Webseite) und Server
• Stateless: Jede Anfrage ist unabhängig – kein Server-Speicher über Anfragen hinweg
• Cacheable: Antworten können zwischengespeichert werden
• Einheitliche Schnittstelle: Standardisierte HTTP-Methoden und -Formate
• Layered System: Die API kann über Zwischenschichten laufen
• Code on Demand (optional): Server kann Code an Client senden

4. Die HTTP-Methoden

RESTful APIs verwenden HTTP-Methoden, um verschiedene Aktionen zu beschreiben.

5. Statuscodes

Statuscodes zeigen an, ob eine API-Anfrage erfolgreich war oder nicht.

6. JSON – Das Daten-Format

JSON (JavaScript Object Notation) ist das Standard-Format für den Datenaustausch bei REST-APIs.

7. Endpoints & Routen

Endpoints sind die URLs, über die eine API angesprochen wird. Sie beschreiben, welche Ressource angesprochen wird.

8. Authentifizierung

Die meisten APIs benötigen eine Authentifizierung, um sicherzustellen, dass nur berechtigte Nutzer darauf zugreifen können.

🔑 Die 4 häufigsten Methoden

// Anfrage mit API-Key (als Query-Parameter)
GET https://api.wetter.de/aktuell?stadt=berlin&api_key=mein_geheimer_key

// Oder im Header
GET https://api.wetter.de/aktuell?stadt=berlin
X-API-Key: mein_geheimer_key

9. API-Sicherheit

Die Sicherheit einer API ist entscheidend, um Daten vor unbefugtem Zugriff zu schützen.

🛡️ Wichtige Sicherheitsmaßnahmen

• HTTPS erzwingen: Alle Anfragen müssen verschlüsselt sein (TLS)
• API-Keys geheim halten: Niemals in Client-Code speichern
• Rate Limiting: Begrenzung der Anfragen pro Benutzer
• Input-Validierung: Alle Eingaben prüfen (SQL-Injection, XSS)
• CORS richtig konfigurieren: Nur erlaubte Domains
• JWT oder OAuth 2.0: Moderne Authentifizierung verwenden
• Logging & Monitoring: Alle API-Zugriffe protokollieren
• Regelmäßige Sicherheitsupdates: Abhängigkeiten aktuell halten

10. Rate Limiting

Rate Limiting begrenzt die Anzahl der Anfragen, die ein Client an eine API senden kann – um Überlastung und Missbrauch zu verhindern.

📊 Wie Rate Limiting funktioniert

11. API-Gateways

Ein API-Gateway ist ein zentraler Einstiegspunkt für alle API-Anfragen. Es übernimmt Aufgaben wie Routing, Authentifizierung, Rate Limiting und Caching.

🧩 Aufgaben eines API-Gateways

• Routing: Anfragen an die richtigen Backend-Services weiterleiten
• Authentifizierung: Prüfung von API-Keys und Tokens
• Rate Limiting: Begrenzung der Anfragen pro Client
• Caching: Zwischenspeicherung von Antworten
• Logging: Protokollierung aller Anfragen
• Transformieren: Antworten umwandeln (z.B. JSON zu XML)

12. API-Versionierung

APIs entwickeln sich weiter – Versionierung stellt sicher, dass bestehende Clients nicht brechen, wenn neue Funktionen hinzukommen.

📌 4 gängige Versionierungs-Strategien

13. Bekannte APIs

📊 14. APIs für Ihr Business – Praxisbeispiele

Hier sind konkrete Beispiele, wie APIs Ihren Arbeitsalltag erleichtern können:

📈 15. Fallstudie: API-gesteuerte Digitalisierung

16. Praxis-Beispiele

📝 Beispiel 1: JavaScript fetch() für eine API

// Eine API mit fetch() aufrufen
fetch('https://api.example.com/kunden')
    .then(response => response.json())
    .then(daten => {
        console.log(daten);
    })
    .catch(fehler => {
        console.error('Fehler:', fehler);
    });

// POST-Anfrage mit Daten
fetch('https://api.example.com/kunden', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        name: 'Anna Müller',
        stadt: 'Berlin'
    })
})
.then(response => response.json())
.then(daten => console.log(daten));

📝 Beispiel 2: REST-API mit Node.js (Express)

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

app.use(express.json());

// GET alle Kunden
app.get('/api/kunden', (req, res) => {
    res.json({
        status: 'success',
        data: ['Anna', 'Ben', 'Clara']
    });
});

// POST neuen Kunden
app.post('/api/kunden', (req, res) => {
    const neuerKunde = req.body;
    res.status(201).json({
        status: 'success',
        data: neuerKunde
    });
});

app.listen(3000, () => {
    console.log('Server läuft auf Port 3000');
});

17. Übungen zum Mitmachen

GET    /api/produkte
GET    /api/produkte/1
POST   /api/produkte
PUT    /api/produkte/1
DELETE /api/produkte/1

✅ 201 Created (Kunde erstellt)
❌ 404 Not Found (Ressource existiert nicht)
🔒 401 Unauthorized (Ungültiger API-Key)

{
    "titel": "Mein erster Blog-Post",
    "inhalt": "Das ist der vollständige Inhalt...",
    "autor": "Anna Müller",
    "datum": "2026-08-13",
    "tags": ["Python", "Web", "API"]
}

// Endpoints
GET    /api/todos          // Alle To-Dos anzeigen
GET    /api/todos/1        // Ein To-Do anzeigen
POST   /api/todos          // Neues To-Do erstellen
PUT    /api/todos/1        // To-Do aktualisieren
DELETE /api/todos/1        // To-Do löschen

// Beispiel JSON für ein To-Do
{
    "id": 1,
    "text": "API lernen",
    "erledigt": false
}

18. Tipps & Best Practices

19. Weiterführende Ressourcen

📚 Online-Lernplattformen

• REST API Tutorial – Umfassendes REST-Tutorial (kostenlos)
• Swagger/OpenAPI – Standard für API-Dokumentation
• Postman – API-Entwicklung und -Testen
• MDN Web Docs – Fetch API – JavaScript fetch() erklärt
• JSON Placeholder – Kostenlose Test-API zum Üben

📖 Empfohlene Bücher

• "RESTful Web APIs" – Leonard Richardson
• "API Design Patterns" – JJ Geewax
• "Web-APIs – Das umfassende Handbuch" – Thomas Theis
• "HTTP – Das umfassende Handbuch" – David Gourley

🛠️ Nützliche Tools

• Postman – API-Entwicklung, Testen und Dokumentation
• Insomnia – Alternative zu Postman (Open Source)
• Swagger UI – Interaktive API-Dokumentation
• JSONPlaceholder – Kostenlose Test-API
• cURL – Kommandozeilen-Tool für HTTP-Anfragen
• HTTPie – Benutzerfreundliches cURL-Ersatz

🌐 Kostenlose APIs zum Üben

• JSONPlaceholder – Fake-API für Posts, Users, Comments
• OpenWeather – Wetter-API (kostenlos bis 60 Anfragen/Minute)
• PokéAPI – Pokémon-Daten (kostenlos, kein API-Key)
• Cat Facts – Zufällige Katzen-Fakten (kostenlos)
• Random User Generator – Zufällige Benutzer-Daten
• CoinGecko – Kryptowährungs-Daten (kostenlos)