Kurz gesagt
Eine API (Application Programming Interface) ist eine Art, wie zwei Programme miteinander reden und Daten austauschen. Statt dass ein Mensch auf einer Website herumklickt, sendet ein Programm eine Anfrage an ein anderes Programm und bekommt eine strukturierte Antwort zurück. Wenn deine App das Wetter zeigt, eine E-Mail sendet oder ein KI-Modell etwas fragt, ruft sie im Hintergrund eine API auf. APIs sind die Leitungen, die die Software, die du baust, mit dem Rest der Welt verbinden.
Die Restaurant-Analogie
Stell dir eine API wie eine Kellnerin vor. Du gehst nicht in die Küche und kochst; du gibst der Kellnerin deine Bestellung, sie bringt sie in die Küche und bringt dir dein Essen. Die API ist die Kellnerin: Du sendest eine Anfrage, die beschreibt, was du willst, und bekommst eine Antwort, ohne je wissen zu müssen, wie die Küche innen funktioniert.
Anfragen und Antworten
Eine Anfrage geht an eine URL (den Endpunkt), oft mit ein paar angehängten Daten. Die Antwort kommt meist als JSON zurück, ein strukturiertes Datenformat. Meistens kümmert sich dein Code oder dein KI Agent um die Details, aber die Form ist immer gleich: Du fragst, du erhältst eine strukturierte Antwort.
{
"city": "Zurich",
"temperature": 18,
"condition": "cloudy"
}API Keys und warum sie zählen
Viele APIs verlangen einen API Key, einen geheimen String, der dich identifiziert und oft die Abrechnung steuert. Weil ein Key dich Geld kosten kann, wenn er geleakt wird, gehört er in eine .env-Datei und nie in Code, der committet wird. Das ist dieselbe Secrets-Disziplin, die jede Zugangsdaten in deinem Projekt schützt.
Häufige Anfänger-Verwirrungen
Ein paar Dinge stolpern Leute. Eine API ist keine Website, die du im Browser besuchst; sie ist ein Dienst, mit dem dein Programm spricht, und eine API-URL direkt zu besuchen zeigt oft nur Rohdaten oder einen Fehler, was normal ist. "Rate Limits" sind eine weitere Überraschung: Viele APIs begrenzen, wie viele Anfragen du in einem Zeitfenster machen kannst, also wenn Aufrufe plötzlich scheitern, gehst du vielleicht einfach zu schnell. Und verschiedene APIs nutzen leicht andere Regeln für Authentifizierung und Anfrageform, weshalb das Lesen der spezifischen API-Dokumentation zählt. Die gute Nachricht: Dein KI Agent liest diese Docs und schreibt den Anfrage-Code für dich, sodass du eine neue API souverän nutzen kannst, ohne ihre Details vorher zu memorieren.