Was eine API ist · Code mit Martin

Entdecke, wie Websites miteinander sprechen – und wie deine Website nach Wetter, Karten oder AI fragen kann.

Ein Kellner zwischen zwei Küchen

Stell dir ein Restaurant vor. Du (deine Website) willst Essen bestellen, darfst aber nicht in die Küche (ein fremder Dienst – Wetter, Karten, AI). Dafür gibt es den Kellner – er nimmt deine Bestellung entgegen, trägt sie in die Küche und bringt dir das fertige Gericht zurück.

Dieser Kellner heißt API (Application Programming Interface). Das ist eine vereinbarte Art, wie Programme einander nach Daten fragen:

Deine Website sendet eine Anfrage („Wie wird das Wetter morgen in Brno?“).
Die API leitet sie an den Dienst weiter, der die Antwort kennt.
Der Dienst liefert eine Antwort in einem vereinbarten Format.

Zeig mir das: JSON – eine gemeinsame Sprache

Programme antworten einander im JSON-Format. Es sieht fast aus wie ein JavaScript-Objekt, das du schon aus dem Zauberer kennst:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

Text steht in Anführungszeichen, Zahlen nicht.
true/false kennst du schon aus Bedingungen.
Eckige Klammern = eine Liste, geschweifte Klammern = ein Objekt.

Probiere es gleich aus – öffne diese Adresse in deinem Browser (das ist eine echte Wetter-API, kostenlos, ohne Registrierung):

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

Du siehst JSON mit dem aktuellen Wetter in Brno. Keine Grafik – nur reine Daten. Die Grafik baust du drumherum!

💡

APIs sind überall. Wenn eine App dir eine Vorhersage, einen Fahrplan oder eine Karte zeigt, hat sie diese Daten fast nie selbst – sie fragt über eine API nach. Jetzt lernst du, dasselbe zu tun.

Jetzt du 💪

Öffne die Adresse oben in deinem Browser und finde die aktuelle Temperatur und Windgeschwindigkeit in der Antwort.
Ändere latitude und longitude in der Adresse auf die Koordinaten deiner Stadt (finde sie auf einem Kartendienst – Rechtsklick → „What’s here?“).
Notiere 2–3 Ideen für dein Projekt, welche externen Daten auf deiner Website nützlich wären:

🏫 Schulwebsite – Ideen

Wetter für einen Schulausflug, eine Karte mit dem Schulstandort, ein Mittagessen-Menü aus der API der Mensa (falls vorhanden), Ferien und Schulferien.

🙋 Persönliche Website – Ideen

Wetter in deiner Stadt, eine Karte mit Orten, an denen du warst, ein AI-Chatbot, der Besuchern Fragen über dich beantwortet.

🌍 Reisetagebuch – Ideen

Eine Karte mit Markierungen für deine Reisen, Wetter am nächsten Ziel, Währungsumrechnung für dein Reisebudget.

⚽ Vereinswebsite – Ideen

Wetter fürs Wochenendspiel, eine Karte des Platzes für Gastmannschaften, ein AI-Helfer, der die Fußballregeln erklärt.

✅

Check: Du kannst erklären, was eine API ist (ein Kellner zwischen Programmen), und JSON erkennen. Du hast eine echte API-Antwort in deinem Browser gesehen.

Das nimmst du aus dieser Lektion mit

API = eine vereinbarte Art, wie Programme einander nach Daten fragen.
Antworten kommen in JSON – Objekte und Listen wie in JavaScript.
In der nächsten Lektion holst du Daten mit fetch direkt auf deine Website.