Zum Hauptinhalt springen

Was ist eine API? 🤔

Wenn Sie mit dem Programmieren lernen beginnen, hören Sie oft das Wort „API". Aber es kann schwierig sein, genau zu verstehen, was eine API ist. In diesem Leitfaden erklären wir APIs auf sehr einfache Weise!

APIs mit dem Alltag vergleichen?​

Vergleichen wir eine API mit einem Restaurant.

Die Geschichte des Restaurants 🍽️​

Wenn Sie in ein Restaurant gehen:

  1. Kunde (Sie): Möchten Essen bestellen
  2. Kellner: Nimmt Ihre Bestellung entgegen und übermittelt sie an die Küche
  3. Küche: Bereitet das Gericht zu
  4. Kellner: Bringt das fertige Gericht zum Kunden

Hier spielt der Kellner genau die Rolle einer API!

Kunde(App) → Kellner(API) → Küche(Server)
                 ↓
Kunde(App) ← Kellner(API) ← Fertiges Gericht(Daten)

Formale Definition von API​

API (Application Programming Interface)

Sie spielt die Rolle einer Brücke, die es Programmen ermöglicht, miteinander zu kommunizieren und Informationen auszutauschen.

Mit echten Beispielen verstehen​

Beispiel 1: Wetter-App ☀️​

Wenn Sie eine Wetter-App öffnen, wird das heutige Wetter angezeigt:

1. Die Wetter-App fordert vom Wetterserver an „Sag mir das Wetter in Seoul heute!"
2. Die API übermittelt diese Anfrage
3. Der Server sucht die Wetterinformationen
4. Die API empfängt die Informationen und übermittelt sie an die App
5. Der App-Bildschirm zeigt „Seoul, Sonnig, 23°C" an

Beispiel 2: Anmeldung 🔐​

Wenn Sie sich mit Ihrem Google-Konto bei einer anderen Website anmelden:

1. Die Website fordert Google an „Überprüfe diese Person"
2. Die Google API überprüft die Benutzerinformationen
3. Wenn bestätigt, antwortet sie der Website mit „OK"
4. Anmeldung abgeschlossen!

Beispiel 3: Karten-App 🗺️​

Der Grund, warum Sie in einer Lieferapp eine Karte sehen können:

Die Lieferapp erstellt die Karte nicht direkt,
Sondern verwendet die Google Maps API, um die Karte zu erhalten!

Wie sieht eine API-Anfrage aus?​

Eine Anfrage an eine API ist wie das Eingeben einer Adresse:

https://api.weather.com/weather?city=Seoul
              ↑              ↑         ↑
       Serveradresse    Was möchten Sie?  Wo?

Vorteile von APIs 🌟​

1. Sie müssen das Rad nicht neu erfinden​

Sie können bereits gut gemachte Funktionen über APIs nutzen.

Beispiele:

  • Zahlungsfunktion: Stripe API verwenden
  • Kartenfunktion: Google Maps API verwenden
  • Anmeldefunktion: Google/Facebook-Anmelde-API verwenden

2. Sie können Informationen sicher austauschen​

Es ist sicher, weil Sie nur über die API zugreifen, ohne direkt auf die Datenbank zuzugreifen.

3. Mehrere Programme können sie gemeinsam nutzen​

Smartphone-Apps, Websites und Tablet-Apps können alle dieselbe API verwenden.

Arten von Web-APIs​

REST API (Am häufigsten)​

Dies ist die am häufigsten verwendete API-Methode im Web.

Merkmale:

  • Anfrage per URL
  • Einfach und leicht zu lernen
  • Von den meisten Webdiensten verwendet

Beispiel:

Abrufen(Lesen):  GET https://api.example.com/users
Erstellen(Schreiben): POST https://api.example.com/users
Ändern:          PUT https://api.example.com/users/123
Löschen:         DELETE https://api.example.com/users/123

GraphQL​

Eine Methode, mit der Sie genau die benötigten Daten anfordern können.

SOAP​

Eine alte API-Methode. Wird heutzutage nicht viel verwendet.

Eine API ausprobieren​

Sie können mit dem API Tester-Tool unserer Website eine echte API ausprobieren!

Einfache Übung​

  1. Gehen Sie zu API Tester
  2. Geben Sie in der URL ein: https://api.github.com/users/github
  3. Wählen Sie GET für Method
  4. Klicken Sie auf die Send-Schaltfläche!

Sie können die öffentlichen Informationen von GitHub abrufen.

Wie sieht eine API-Antwort aus?​

APIs senden Daten normalerweise im JSON-Format:

{
  "name": "GitHub",
  "location": "San Francisco",
  "public_repos": 344
}
Tipp

Fragen Sie sich, was JSON ist? Schauen Sie sich das Dokument JSON-Datenformat verstehen an!

Praktische Anwendungsbeispiele​

Einen Blog erstellen​

Blog-Beitragsliste anzeigen:
GET https://myblog.com/api/posts

Neuen Beitrag erstellen:
POST https://myblog.com/api/posts

Einen Online-Shop erstellen​

Produktliste anzeigen:
GET https://myshop.com/api/products

Zum Warenkorb hinzufügen:
POST https://myshop.com/api/cart

Zusammenfassung wichtiger Begriffe​

BegriffBedeutungBeispiel
Anfrage (Request)Etwas vom Server anfordern„Gib mir Wetterinformationen"
Antwort (Response)Die vom Server gesendete Antwort„Seoul ist sonnig"
Endpunkt (Endpoint)Die Adresse der API/api/weather
Methode (Method)Welche Aktion ausführenGET, POST, PUT, DELETE
JSONDatenaustauschformat{"city": "Seoul"}

Häufig gestellte Fragen (FAQ)​

F1: Sind APIs kostenlos?​

A: Es hängt von jeder API ab!

  • Kostenlose API: Öffentliche Daten, GitHub usw.
  • Teilweise kostenlose API: Bis zu einer bestimmten Anzahl pro Tag kostenlos (Google Maps usw.)
  • Kostenpflichtige API: Zahlungssystem, Premium-Daten usw.

F2: Wie erstellt man eine API?​

A: Sie müssen Backend-Programmierung lernen.

  • Node.js + Express
  • Python + Django/Flask
  • Java + Spring Sie können APIs erstellen, indem Sie diese Technologien lernen!

F3: Was ist ein API-Schlüssel?​

A: Es ist wie ein Passwort, mit dem Sie die API verwenden können.

https://api.example.com/data?key=YOUR_API_KEY_HERE

F4: Was tun, wenn ein Fehler auftritt?​

A: Die API informiert Sie mit Fehlercodes:

  • 200: Erfolg!
  • 404: Nicht gefunden
  • 500: Serverfehler

Für weitere Details siehe HTTP-Statuscodes-Leitfaden!

Nächste Schritte 🚀​

Wenn Sie die Grundlagen von APIs verstanden haben:

  1. ✅ JSON-Datenformat verstehen - Wie APIs Daten austauschen
  2. ✅ API Tester - APIs direkt verwenden
  3. ✅ HTTP-Statuscodes-Leitfaden - API-Antwortcodes verstehen
  4. ✅ cURL-Konverter - API-Anfragen in verschiedene Formate konvertieren

Zusammenfassung​

APIs sind nicht schwierig! Betrachten Sie sie als die Art und Weise, wie Programme miteinander kommunizieren.

Wie ein Kellner in einem Restaurant:

  • Empfängt unsere Anfrage
  • Übermittelt sie an den Server
  • Und bringt das Ergebnis zurück

Verstehen Sie jetzt, was eine API ist? 🎉