Was ist eine API? Ein verständlicher Leitfaden für App-Bauer

Eine API (Application Programming Interface) ist eine festgelegte Art, wie eine Software-Komponente eine andere nach Daten fragen oder sie zu etwas auffordern kann. Deine App sendet eine Anfrage in einem vereinbarten Format – „Gib mir die Buchungen von morgen“, „belaste diese Karte mit 20 €“, „fasse diesen Text zusammen“ – und das andere System schickt eine strukturierte Antwort zurück. APIs sind die Art, wie die Teile einer App miteinander sprechen, und wie deine App externe Dienste wie Zahlungen, E-Mail, Karten und KI nutzt.

Warum APIs beim Bauen mit KI wichtig sind

Fast jede nützliche App besteht aus Teilen, die über APIs kommunizieren:

• Innerhalb deiner App rufen die Bildschirme im Browser die API deines eigenen Backends auf, um Daten zu laden und zu speichern.
• Außerhalb deiner App ruft dein Backend die APIs anderer Unternehmen auf: Stripe für Zahlungen, einen E-Mail-Anbieter für Quittungen, einen KI-Modellanbieter für Texterzeugung.

Wenn du deinen KI-Builder bittest, „Zahlungen anzunehmen“ oder „eine KI-Zusammenfassung hinzuzufügen“, schreibt er im Grunde Code, der eine API aufruft. Grundkenntnisse helfen dir zu verstehen, was die KI von dir braucht (meist ein Konto beim jeweiligen Dienst und einen API-Schlüssel), wo Dinge schiefgehen können und was sie kosten.

Ein Alltagsvergleich

Denk an ein Restaurant. Du gehst nicht in die Küche und kochst. Du liest die Speisekarte, sagst dem Kellner, was du willst, in einer Form, die die Küche versteht, und der Kellner bringt dein Essen – oder sagt, dass das Gericht ausverkauft ist.

• Die Speisekarte ist die API-Dokumentation: eine Liste dessen, was du anfragen kannst, und wie.
• Der Kellner ist die API: der eine vereinbarte Weg, auf dem Anfragen hinein- und Antworten herauskommen.
• Die Küche ist das andere System: Du musst nicht wissen, wie sie innen funktioniert.
• Deine Bestellung ist die Anfrage; der Teller ist die Antwort.

Die Küche kann ihre Öfen und ihr Personal ändern, ohne dich zu betreffen, solange die Speisekarte gleich bleibt. Darin liegt der eigentliche Wert einer API: Sie lässt zwei Systeme zusammenarbeiten, ohne dass eines wissen muss, wie das andere gebaut ist.

Wie eine Web-API-Anfrage funktioniert

Die meisten APIs, denen du begegnest, sind Web-APIs, die über HTTP laufen – dasselbe Protokoll, das dein Browser nutzt. Jede Anfrage hat ein paar Teile:

Und jede Antwort hat:

JSON (JavaScript Object Notation) ist ein einfaches Textformat aus Namen und Werten in geschweiften Klammern. Es ist der Standard, mit dem Web-APIs Daten austauschen.

REST: der verbreitetste Stil

REST ist eine weit verbreitete Konvention für den Entwurf von Web-APIs. Jede Art von Objekt bekommt eine eigene URL, und Standardmethoden sagen, was du damit tust. So könnte eine REST-API für eine Buchungs-App aussehen:

PUT existiert ebenfalls und ersetzt konventionell einen ganzen Datensatz, während PATCH nur die Felder ändert, die du sendest.

Die Statuscodes, denen du am häufigsten begegnest:

Wenn deine App kaputtgeht, ist der Statuscode oft der schnellste Hinweis. Ein 401 von einem Zahlungsanbieter bedeutet meist einen fehlenden oder falschen API-Schlüssel; ein 429 bedeutet, dass du zu oft anfragst.

REST ist nicht der einzige Stil – es gibt auch GraphQL und RPC-artige APIs –, aber REST ist das, was die meisten Dienste und mit KI gebauten Backends verwenden.

Ein Beispiel: eine Buchungsbestätigung

Wenn ein Kunde in einer Salon-App einen Haarschnitt bucht, können innerhalb von ein oder zwei Sekunden mehrere API-Aufrufe stattfinden:

1. Die Buchungsseite im Browser sendet POST /api/bookings mit Leistung, Uhrzeit und Kundendaten an dein Backend.
2. Dein Backend prüft, ob der Termin frei ist, speichert die Buchung in der Datenbank und gibt 201 Created zurück.
3. Dein Backend ruft die API eines E-Mail-Anbieters mit dessen geheimem Schlüssel auf: „Schick diese Bestätigung an lena@example.com.“
4. Gibt es eine Anzahlung, bittet dein Backend die API des Zahlungsanbieters, eine Checkout-Sitzung zu erstellen, und schickt den Kunden dorthin.
5. Später ruft der Zahlungsanbieter deine App an, um mitzuteilen, dass die Zahlung erfolgreich war. Dieser umgekehrte Aufruf ist ein Webhook.

Die ersten beiden Schritte sind deine eigene API zwischen Frontend und Backend. Die Schritte 3–5 sind APIs von Drittanbietern.

Häufige Begriffe erklärt

Häufige Fehler und Missverständnisse

• Geheime Schlüssel ins Frontend legen. Alles, was im Browser läuft, kann jeder sehen, der die Seite besucht. Geheime Schlüssel müssen auf dem Server bleiben, in Umgebungsvariablen oder Secrets.
• Schlüssel in den Chat kopieren. Der Chatverlauf kann gespeichert werden. Nutze stattdessen die Secrets-Funktion deines Builders und tausche jeden Schlüssel aus, der offengelegt wurde.
• Annehmen, dass eine API kostenlos ist. Viele APIs berechnen pro Anfrage oder pro Nutzungseinheit – KI-Modell-APIs rechnen nach Tokens ab. Prüfe die Preise und setze Ausgabenlimits. Siehe wie du LLM-APIs nutzt.
• Fehler nicht behandeln. Externe Dienste fallen aus, laufen in Timeouts und stoßen an Limits. Bitte um sinnvolle Fehlermeldungen und Wiederholungsversuche.
• Dem Browser vertrauen. Deine eigene API muss Berechtigungen selbst prüfen. Einen Button auszublenden verhindert nicht, dass jemand den Endpunkt direkt aufruft.
• Live-Schlüssel beim Testen verwenden. Nutze Schlüssel aus dem Testmodus, bis du zum Start bereit bist.

Was du deinen KI-Builder fragen solltest

• „Welche externen APIs nutzt diese App, und was kostet jede davon?“
• „Rufe die Zahlungs-API nur vom Server aus auf. Lies den Schlüssel aus einer Umgebungsvariable.“
• „Liste jeden Endpunkt unserer API auf, was er tut und wer ihn aufrufen darf.“
• „Prüfe auf dem Server, dass der angemeldete Nutzer die Buchung besitzt, bevor du sie aktualisierst oder löschst.“
• „Wenn die E-Mail-API ausfällt, speichere die Buchung trotzdem und protokolliere den Fehler.“
• „Verwende vorerst den Testmodus des Anbieters.“

APIs in Mythex

Mythex kann deine eigene API bauen – als Teil einer Web-App oder als eigenes Backend in Node, Python (FastAPI), C# oder Java, das neben deinem Frontend läuft – und den Code schreiben, der externe Dienste aufruft. Du hinterlegst deren Schlüssel als Projekt-Secrets statt im Chat, und sie stehen deiner App in der Vorschau und nach der Veröffentlichung zur Verfügung. Die Dokumentation enthält Rezepte für die Integration beliebiger APIs und ein REST-API-Backend.

Fragen