Was ist eine Public API?

Eine Public API (öffentliche API, Application Programming Interface) ist eine Schnittstelle, über die jeder im Internet externe Tools in seine Website oder Anwendung integrieren kann. Dafür stellt der API-Anbieter Endpunkte bereit, über die Nutzer bestimmte Dienste oder Daten vom Server anfordern können.

Entwickler nutzen Public APIs, weil sie effizient und einfach zu verwenden sind und Zugriff auf umfangreiche Datenbestände bieten. So können sie ihre Anwendungen erweitern, ohne alles von Grund auf selbst entwickeln zu müssen. Im Gegensatz zu privaten oder internen APIs sind Public APIs kostenlos und für jeden zugänglich.

Eine Public API lässt sich in fünf einfachen Schritten nutzen:

1. Suchen Sie auf einer Website oder Plattform wie GitHub nach einer Public API.
2. Lesen Sie die API-Dokumentation, um sich über Spezifikationen, Funktionen und Anforderungen zu informieren.
3. Registrieren Sie sich auf der Website des API-Anbieters, um den Endpunkt und den Authentifizierungsschlüssel zu erhalten.
4. Testen Sie die API, indem Sie mit einem Tool wie cURL oder Postman eine Anfrage an den Server senden.
5. Integrieren Sie die Public API in Ihre Anwendung, indem Sie die entsprechenden Funktionen in das Backend einbinden.

Im Folgenden erfahren Sie mehr darüber, was eine Public API ist, wo Sie eine solche Schnittstelle finden und wie Sie diese in Ihre Anwendung integrieren.

Wie funktioniert eine Public API?

Wie eine Public API funktioniert, lässt sich am Beispiel eines Restaurants erklären.

Stellen Sie sich ein Restaurant vor, in das jeder hineingehen und ein Gericht seiner Wahl bestellen kann. Ähnlich funktioniert eine Public API: Entwickler können darüber auf verschiedene Daten oder Dienste zugreifen.

Die Nutzung einer Public API lässt sich mit einer Restaurantbestellung vergleichen. Auch hier gibt es einen bestimmten Ablauf, bei dem verschiedene Komponenten zusammenwirken, um Ihre Anfrage zu bearbeiten. Sehen wir uns die einzelnen Bestandteile genauer an.

Endpunkte

In einem Restaurant wählen Sie das gewünschte Gericht von der Speisekarte aus. So teilen Sie den Köchen in der Küche mit, was Sie essen möchten.

Bei APIs entsprechen die Gerichte auf der Speisekarte den Endpunkten. Das sind URLs, über die Sie auf bestimmte Dienste, Tools oder Daten zugreifen können. Die Endpunkte werden an die Basis-URL der API angehängt, beispielsweise:

api-provider.com/service

HTTP-Methoden

Mit HTTP-Methoden legt Ihre Anwendung fest, welche Aktion bei einer API-Anfrage ausgeführt werden soll. Das ist vergleichbar damit, wie Sie einem Kellner im Restaurant Ihre Bestellung mitteilen.

Die folgende Tabelle zeigt die HTTP-Methoden, ihre Funktionen und die entsprechenden Beispiele aus dem Restaurant:

API-Antwort

Eine API-Antwort enthält die Informationen, die der Server als Reaktion auf eine Anfrage im JSON-Format zurückgibt. Dazu können beispielsweise eine Liste mit Daten oder der Status der Anfrage gehören.

Im Restaurant entspricht die API-Antwort einer Quittung, die Sie erhalten, nachdem Sie eine Bestellung aufgegeben, geändert, überprüft oder storniert haben. Sie könnte beispielsweise so aussehen:

{
  "order_id": 123,
  "item": "Cheeseburger",
  "status": "preparing"
}

Rate-Limiting

Beim Rate-Limiting wird festgelegt, wie viele Anfragen eine API innerhalb eines bestimmten Zeitraums maximal verarbeiten darf. Das soll eine Überlastung der API verhindern, die dazu führen könnte, dass sie nicht mehr reagiert oder ausfällt.

Das ist vergleichbar mit einer Regel in einem Restaurant, nach der innerhalb eines bestimmten Zeitraums nur eine bestimmte Anzahl von Bestellungen angenommen werden darf.

API-Schlüssel

API-Schlüssel sind Autorisierungstoken, mit denen der Anbieter überprüft, ob Anfragen gültig und legitim sind. Das erhöht die Sicherheit und spielt insbesondere beim Rate-Limiting eine wichtige Rolle, da der API-Anbieter die einzelnen Anfragesteller damit nachverfolgen kann.

API-Schlüssel lassen sich mit einer Reservierungsbestätigung im Restaurant vergleichen. Anhand dieser Bestätigung lässt sich überprüfen, wer Sie sind und wann Sie Zutritt haben.

Warum nutzen Entwickler Public APIs?

Entwickler setzen Public APIs aus verschiedenen Gründen ein:

• Effizienz. Entwickler können Funktionen wie Karten oder Zahlungsgateways in ihre Anwendungen integrieren, ohne sie selbst von Grund auf entwickeln zu müssen. Das spart Zeit und Aufwand.
• Integration in bestehende Ökosysteme. Über Public APIs lassen sich gängige Plattformen mit eigenen Anwendungen verbinden. So können Entwickler beispielsweise eine Registrierung über ein Google-Konto ermöglichen.
• Schnelleres Prototyping. Bei der Entwicklung eines Anwendungsprototyps müssen Entwickler Funktionen schnell und flexibel hinzufügen können. Mithilfe von APIs ist das nahezu sofort möglich.
• Skalierbarkeit. Da die API-Anbieter die bereitgestellten Dienste verwalten, müssen Sie sich nicht selbst um deren Wartung kümmern und können sich auf Ihre Anwendung konzentrieren.
• Datenzugriff. Über Public APIs können Anwendungsentwickler mit geringem Aufwand auf bereits verfügbare Daten und Echtzeitdaten zugreifen und diese in ihre Anwendungen integrieren.

Anwendungsfälle für Public APIs

Public APIs bilden die Grundlage für viele Funktionen, die wir täglich nutzen. Ob eingebettete Karten oder die Abwicklung von Zahlungen: Entwickler setzen sie unter anderem für folgende Zwecke ein:

• Suche und Zugriff auf Inhalte. Ermöglichen Sie Nutzern, gezielt nach Inhalten auf externen Plattformen zu suchen und darauf zuzugreifen. Mit der YouTube-API können Anwendungen beispielsweise nach Videos suchen, Informationen dazu abrufen und die Videos direkt einbetten.
• Wetter. Stellen Sie Nutzern Wetterdaten und Vorhersagen in Echtzeit zur Verfügung. Über die OpenWeatherMap-API können Sie beispielsweise die aktuellen Wetterbedingungen, Vorhersagen für mehrere Tage und Wetterwarnungen anzeigen.
• Karten. Binden Sie interaktive Karten in Ihre Anwendung ein und ermöglichen Sie standortbezogene Dienste. Die Google Maps-API unterstützt beispielsweise die Adresssuche, die Routenplanung und die Suche nach Orten in der Nähe.
• Zahlungsabwicklung und E-Commerce. Ermöglichen Sie sichere Online-Zahlungen und verwalten Sie Transaktionen in Ihrem Online-Shop. Die Stripe-API unterstützt beispielsweise die Verarbeitung von Kreditkartenzahlungen, die Abrechnung von Abonnements und die Bestellabwicklung.
• Soziale Medien und Messaging-Dienste. Integrieren Sie Funktionen für soziale Interaktionen und die Kommunikation. Über die X-API lassen sich beispielsweise Inhalte veröffentlichen, Nutzerdaten abrufen und Kennzahlen zur Nutzerinteraktion erfassen.
• Dienstverwaltung. Optimieren Sie die Benutzerauthentifizierung, Terminplanung oder den Kundensupport. Die Hostinger-API erleichtert beispielsweise Kaufvorgänge, die Produktverwaltung und den Abruf von Informationen.

Vergleich verschiedener API-Typen

Neben Public APIs gibt es weitere API-Typen für unterschiedliche Anwendungsfälle. Im Folgenden werden die Unterschiede erläutert.

Public API vs. Private API

Ähnlich wie eine Public API kann auch eine Private API von externen Parteien genutzt werden. Der Zugriff ist jedoch auf berechtigte Nutzer beschränkt, beispielsweise Abonnenten oder Partner.

Eine Public API dagegen kann jeder kostenlos nutzen, sofern der entsprechende Endpunkt und ein gültiger Authentifizierungsschlüssel vorhanden sind.

Public API vs. Internal API

Eine interne API steht ausschließlich den Entwicklern oder Organisationen zur Verfügung, die sie erstellt haben. Sie ist speziell auf deren Anforderungen zugeschnitten und dient dazu, verschiedene Dienste, Tools und Funktionen innerhalb eines Projekts miteinander zu verbinden.

Beispielsweise nutzen Anwendungen mit einer Microservice-Architektur häufig interne APIs, um Benutzeranfragen zu unterscheiden und an die zuständigen Dienste weiterzuleiten, etwa für die Authentifizierung oder Datenbankoperationen.

Wie können Sie eine Public API nutzen?

Die einzelnen Schritte zur Nutzung und Integration einer Public API können je nach Anbieter leicht variieren. Die grundlegende Vorgehensweise bleibt jedoch weitgehend gleich.

1. Suchen Sie eine Public API

Suchen Sie zunächst eine Public API, die Ihren Anforderungen und Präferenzen entspricht. In verschiedenen Repositories finden Sie eine große Auswahl, darunter die Liste der Public APIs auf GitHub.

Berücksichtigen Sie bei der Auswahl einer geeigneten Public API folgende Kriterien:

• Seriosität. Eine API von einem renommierten Unternehmen oder mit positiven Nutzerbewertungen gilt als zuverlässig und sicher. Das gibt Ihnen bei der Nutzung ein gutes Gefühl.
• Funktionen. Public APIs unterscheiden sich in ihrem Funktionsumfang. Wählen Sie daher eine API, die die Anforderungen Ihrer Anwendung erfüllt.
• Qualität der Dokumentation. Eine umfassende Dokumentation erleichtert es Ihnen, die Funktionsweise der API zu verstehen, sie zu integrieren und mögliche Fehler zu beheben.
• Rate-Limits. Wenn Ihre Anwendung häufig API-Aufrufe ausführt, sollten Sie eine Public API mit einem höheren Rate-Limit wählen. So bleibt die API auch bei Traffic-Spitzen reaktionsfähig.
• Community und Support. Eine aktive Community und guter Support erleichtern die API-Integration, da Sie bei Bedarf unkompliziert Hilfe erhalten können.
• Authentifizierung und Sicherheit. Die ideale API sollte ein sicheres Authentifizierungsverfahren bieten, das den Anforderungen Ihrer Anwendung entspricht, beispielsweise OAuth oder einen API-Schlüssel.
• Lizenzierung und Nutzungsbedingungen. Wenn Sie die Dienste oder Daten der API kommerziell nutzen möchten, stellen Sie sicher, dass die Lizenz dies erlaubt.

2. Lesen Sie die API-Dokumentation

Lesen Sie die API-Dokumentation sorgfältig durch, um die Funktionsweise der API zu verstehen und sie korrekt in Ihre Anwendung zu integrieren.

Die Dokumentation enthält wichtige Informationen zur Public API, darunter:

• Basis-URL. Die Hauptadresse der API, über die Sie auf die Endpunkte zugreifen können, beispielsweise api.hostinger.com/v1/.
• Endpunkt. Die Adresse, über die Ihre Anwendung auf bestimmte Dienste oder Daten zugreift. Der Endpunkt wird an die Basis-URL angehängt, beispielsweise api.hostinger.com/v1/endpoint/.
• Authentifizierung. Das Verfahren, mit dem die API Ihre Anwendung authentifiziert. Um auf den Endpunkt zugreifen zu können, müssen Sie das vorgesehene Verfahren verwenden.
• Unterstützte Methoden. Die HTTP-Methoden, mit denen Ihre Anwendung Daten oder Dienste von der API anfordern kann.
• Formatierung. Die Struktur der API-Antwort. Da sie sich je nach API unterscheidet, müssen Sie das Format kennen, um die Daten auf Ihrer Website korrekt darzustellen.
• Parameter. Erforderliche und optionale Variablen, die Sie in einer API-Anfrage angeben, um bestimmte Daten abzurufen.
• Statuscode. Ein Code, der anzeigt, ob ein API-Aufruf erfolgreich war oder nicht. Diese Information ist wichtig für die Fehlerbehebung und die Implementierung einer entsprechenden Fehlerbehandlung.

3. Registrieren Sie sich und generieren Sie einen API-Schlüssel

Um den Endpunkt und den API-Schlüssel zu erhalten, müssen Sie ein Konto auf der Plattform des API-Anbieters erstellen. Der grundlegende Ablauf ist bei den meisten Anbietern ähnlich, auch wenn sich die einzelnen Schritte leicht unterscheiden können.

Am Beispiel von Hostinger zeigen wir Ihnen, wie Sie ein Konto erstellen und einen API-Schlüssel generieren.

1. Öffnen Sie die Registrierungsseite von Hostinger.
2. Geben Sie Ihre E-Mail-Adresse und Ihr Passwort ein. Klicken Sie anschließend auf Registrieren.
3. Melden Sie sich mit Ihrem neuen Hostinger-Konto an und öffnen Sie das Hostinger-Dashboard.
4. Klicken Sie auf das Profilsymbol und wählen Sie Kontoinformationen.

5. Navigieren Sie in der Seitenleiste zu API.
6. Klicken Sie auf Neues Token. Daraufhin öffnet sich das Fenster zum Erstellen eines API-Schlüssels.
7. Geben Sie einen Namen für das Token ein und legen Sie ein Ablaufdatum fest. Klicken Sie anschließend auf Erstellen.

Bewahren Sie den generierten API-Schlüssel an einem sicheren Ort auf, da Sie ihn später benötigen. Beachten Sie, dass API-Anbieter aus Sicherheitsgründen häufig verhindern, dass Sie den Schlüssel nach dem Schließen der Seite zur Token-Generierung erneut einsehen können.

4. Testen Sie die API mit Postman oder cURL

Am einfachsten testen Sie eine API mit dem cURL-Befehl. Mit diesem Tool können Sie mithilfe verschiedener HTTP-Methoden Anfragen an einen Server senden, in diesem Fall an einen API-Endpunkt.

Öffnen Sie dazu das Terminal oder die Eingabeaufforderung Ihres Computers und verwenden Sie folgende Befehlssyntax:

curl -X method "URL"  -H "Authentication: API-key"

Ersetzen Sie method durch die entsprechende HTTP-Methode und URL durch die Adresse des Endpunkts. Ein Befehl könnte beispielsweise so aussehen:

curl -X GET "https://developers.hostinger.com/api/vps/v1/virtual-machines"  -H "Authentication: Bearer abcd123efgh456"

Je nach API-Spezifikation müssen Sie möglicherweise weitere Angaben zur Anfrage in den Befehl aufnehmen. Informationen zu den jeweiligen Testanforderungen finden Sie in der API-Dokumentation.

Eine weitere beliebte Möglichkeit zum Testen von APIs ist Postman. Die Software verfügt über eine grafische Benutzeroberfläche und bietet umfangreichere Funktionen als cURL. Dadurch eignet sie sich insbesondere für komplexe API-Tests mit mehreren Endpunkten.

So testen Sie eine API mit Postman:

1. Laden Sie Postman herunter und installieren Sie die Software auf Ihrem Computer.
2. Öffnen Sie den Postman-Client. Wenn Sie Ihren Testfortschritt speichern möchten, können Sie optional ein Konto erstellen. Für einfache Tests ist keine Registrierung erforderlich.
3. Wählen Sie im Dashboard die gewünschte HTTP-Methode aus.
4. Geben Sie den API-Endpunkt in das dafür vorgesehene Feld ein.
5. Öffnen Sie die Registerkarte Autorisierung und wählen Sie die Authentifizierungsmethode aus, die in der API-Spezifikation angegeben ist.
6. Geben Sie die Zugangsdaten in die entsprechenden Felder ein.
7. Klicken Sie auf Senden, um die API-Anfrage abzuschicken.

War der API-Aufruf erfolgreich, wird die JSON-Antwort im unteren Bereich des Postman-Clients angezeigt.

5. Integrieren Sie die Public API in Ihr Projekt

Welche Schritte für die Integration einer Public API in Ihr Projekt erforderlich sind, hängt vom API-Typ, der Projektstruktur und der verwendeten Programmiersprache oder Technologie ab.

In der Regel binden Sie die API in das Backend Ihrer Anwendung ein und rufen sie über das Frontend auf. Dafür benötigen Sie folgende Komponenten:

• Authentifizierungstoken. Der API-Schlüssel wird normalerweise in einer Umgebungsvariable Ihres Projekts gespeichert und mithilfe von dotenv im Anwendungscode abgerufen. Damit das Token nicht offengelegt wird, sollte es nicht direkt in den Hauptdateien Ihrer Anwendung stehen.
• API-Proxy-Code. Dieser Teil des Codes verbindet Ihre Anwendung mit dem API-Endpunkt, um Daten abzurufen. Er enthält außerdem die Parameter für die API-Anfrage.
• Backend-Callback. Diese Funktion im Frontend Ihrer Anwendung ruft die entsprechende API-Funktion im Backend auf.
• Code zur Datenformatierung. Dieser Teil des Frontends liest die abgerufenen JSON-Daten und bereitet sie für die Darstellung auf.

Als Beispiel dient eine einfache Website mit Express.js und HTML, die über die Hostinger-API die Ressourcenauslastung Ihres Linux-VPS-Hostings abruft und anzeigt.

Der API-Proxy-Code sieht folgendermaßen aus:

app.get('/api/metrics', async (req, res) => {
  const { vmId, date_from, date_to } = req.query;

  if (!vmId || !date_from || !date_to) {
    return res.status(400).json({ error: 'Missing parameters' });
  }

  const url = `${API_BASE_URL}/api/vps/v1/virtual-machines/${vmId}/metrics?date_from=${date_from}&date_to=${date_to}`;

  try {
    const response = await fetch(url, {
      headers: {
        'Authorization': `Bearer ${BEARER_TOKEN}`
      }
    });

Die Funktion für den Aufruf des Backends befindet sich in der Datei index.html unserer Website und sieht so aus:

const res = await fetch(`/api/metrics?vmId=${vmId}&date_from=${dateFrom}&date_to=${dateTo}`);
const data = await res.json();

Die Datei index.html enthält außerdem folgenden Code, der die abgerufenen JSON-Daten ausliest und in einem einfacheren, besser lesbaren Format darstellt:

results.innerHTML = `
<div class="metric">
  <h3>CPU Usage</h3>
  ${data.cpu_usage.usage[ts]} ${data.cpu_usage.unit}
</div>

<div class="metric">
  <h3>RAM Usage</h3>
  ${formatBytes(data.ram_usage.usage[ts])}
</div>

<div class="metric">
  <h3>Disk Space</h3>
  ${formatBytes(data.disk_space.usage[ts])}
</div>

Einige API-Anbieter stellen außerdem Software Development Kits (SDKs) bereit. Die SDKs enthalten vorgefertigte Tools und Bibliotheken, die die Integration erleichtern. Mit den SDKs der Hostinger-API können Sie beispielsweise unsere Hosting-Dienste unkompliziert mit Ihren PHP-, Python- oder TypeScript-Anwendungen verbinden.

Wo finden Sie Public APIs?

Auf verschiedenen Websites, in Repositories und auf Plattformen finden Sie Verzeichnisse von Public APIs. Zu den bekanntesten gehören:

• RapidAPI. Der weltweit größte Marktplatz für Public APIs bietet über 40.000 APIs aus verschiedenen Bereichen, darunter E-Commerce, Cybersicherheit und soziale Medien. Unternehmen können dort außerdem maßgeschneiderte APIs mit spezifischen Funktionen erhalten.
• Free-APIs. Ein Repository mit einem umfangreichen Verzeichnis von APIs verschiedener Entwickler und Unternehmen, darunter Google und Trello.
• Postman. Ein sehr beliebtes Portal für Public APIs mit einer großen Auswahl an Schnittstellen. Dank ausführlicher Dokumentationen und einer integrierten Testfunktion eignet es sich besonders, wenn Sie eine API eingehend prüfen möchten.
• GitHub. Auf der Plattform finden Sie mehrere von der Community zusammengestellte Verzeichnisse von Public APIs. GitHub eignet sich hervorragend für die Suche nach spezialisierten APIs. Da die Plattform jedoch nicht speziell für diesen Zweck entwickelt wurde, kann die Navigation etwas umständlich sein.

Fazit

Mit einer Public API können Sie umfangreiche Datenquellen oder sofort nutzbare Funktionen einfach in Ihre Anwendung integrieren.

Public APIs verbessern nicht nur die Entwicklungseffizienz, sondern tragen auch dazu bei, schwerwiegende Fehler zu reduzieren, die zu Fehlfunktionen oder Ausfallzeiten führen können. Denn dafür müssen Sie den bestehenden Anwendungscode nicht umfassend ändern.

Testen Sie eine API, bevor Sie sie in Ihre Anwendung integrieren, um ihre Funktionsweise besser kennenzulernen. Wir empfehlen dafür die Hostinger-API, da sie kostenlos ist, zahlreiche Endpunkte bietet und umfassend dokumentiert ist.

Sie können die Hostinger-API auch in Anwendungen integrieren, die das Model Context Protocol (MCP) unterstützen, beispielsweise Claude. So können Sie Ihr Hosting KI-gestützt verwalten.

Dieser Artikel ist eine lokalisierte Version von What is a public API?, der ursprünglich in englischer Sprache veröffentlicht wurde.

Alle Tutorial-Inhalte auf dieser Website unterliegen Hostingers strengen redaktionellen Standards und Werten.

Erstellt von

Faradilla Ayunindya

Add Hostinger as a preferred source on Google

Faradilla, auch bekannt als Ninda, ist Content Marketing Specialist bei Hostinger mit über fünf Jahren Erfahrung und einem zehnjährigen Hintergrund als Linguistin. Sie möchte Technologie für alle zugänglich machen, indem sie komplexe Anleitungen in klare und leicht verständliche Schritt-für-Schritt-Guides verwandelt. In ihrer Freizeit interessiert sie sich für Biowissenschaften oder schaut gerne lustige Tiervideos. Vernetzen Sie sich mit ihr auf LinkedIn.

Mehr von Faradilla Ayunindya