Was ist eine API? [Schnell gelesen]

Wenn Sie kein Entwickler sind, aber im technischen Bereich arbeiten, verstehen Sie den Begriff API wahrscheinlich im umgangssprachlichen Sinne. Sie wissen wahrscheinlich, wofür es steht (Application Programming Interface), und vielleicht verwenden Ihre Teams APIs, um ihre Arbeit zu erledigen – oder vielleicht ist es sogar das Produkt selbst (z. B. Twilio SendGrid).

Aber was genau ist eine API und wie funktioniert sie?

Das Verständnis der tieferen Prinzipien hinter APIs wird Ihnen helfen, diese Technologien selbst besser zu vermarkten, zu verkaufen oder zu nutzen.

Dieser Beitrag erklärt, wie APIs funktionieren, wie Entwickler sie erstellen und wie sie verwendet werden (mit Beispielen aus der Praxis).

Wie funktionieren APIs?

Wie Webbrowser mit Servern interagieren, ist ein grundlegendes Prinzip von APIs. Das Web ist eine Sammlung von Remote-Servern, die über den ganzen Planeten verstreut sind. Wenn Sie einen Browser öffnen und eine Website eingeben, ruft der Browser den Server des Clients (unabhängig von der Anwendung oder dem Server, auf dem eine Website gehostet wird) auf, um alles abzurufen und anzuzeigen, was sich auf dieser URL befindet.

Während eine API nicht der Server selbst ist, ist es der Teil des Servers, der als Endpunkt bezeichnet wird und bestimmte Antworten sendet und empfängt. APIs sind eine Möglichkeit für verschiedene Softwarekomponenten, miteinander zu kommunizieren (auch bekannt als Senden und Empfangen), indem Endpunkte geöffnet werden.

Entwickler richten API-Aufrufe ein, um bestimmte Daten abzurufen, die für verschiedene Zwecke benötigt werden, wenn sie Anwendungen oder Websites erstellen. Zum Beispiel:

• Hast du gerade deine Instagram-App geöffnet? Möglich wurde dies durch einen API-Aufruf.
• Haben Sie schon einmal einen Termin von einer anderen Website oder E-Mail zu Ihrem Google Kalender hinzugefügt? Diese Website nutzte die Google Kalender-API, um diese spezifischen Informationen vom Google Kalender-Server abzurufen.

Fazit: Entwickler richten API-Aufrufe ein, um bestimmte Datentypen abzurufen und anzuzeigen, was sie benötigen, wenn ein Benutzer auf einer Website ist oder eine Anwendung ausführt.

Der Aufstieg von REST

Ein anderer Begriff, den Sie wahrscheinlich schon gehört haben, ist REST-API. Es unterscheidet sich nicht per se von der traditionellen Definition einer API. Dennoch lohnt es sich zu verstehen, warum REST-APIs so beliebt geworden sind und was REST-APIs von anderen unterscheidet.

Am Anfang wurden APIs entwickelt, um die Anforderungen von SOAP (Simple Object Access Protocol) zu erfüllen. Diese Methode war jedoch etwas mühsam und erforderte viel Bandbreite, um Datensätze zu übertragen. Es erforderte auch viel Entwicklerenergie (wie nicht die lustige Art). SOAP verwendet die notorisch schwere XML-Markup-Sprache, um Daten anzuzeigen. Nützlich, um universelle Kompatibilität zu gewährleisten – aber das war es auch schon.

Entwickler suchten nach einfacheren und flexibleren Möglichkeiten, API-Aufrufe durchzuführen. REST-APIs (representational state transfer) bieten eine alternative Lösung zur SOAP-API. Sie sind nicht an ein bestimmtes Protokoll gebunden, obwohl sie bestimmten architektonischen Stilen entsprechen müssen (wenn Sie daran interessiert sind, gehen Sie hierher).

Anstatt mit XML-Markup angezeigt zu werden, verwendet der Server stattdessen die leichtgewichtige JSON-Sprache (nur Textdateien). REST-APIs haben eine viel geringere Bandbreite als SOAP – sie sind normalerweise nur eine URL – und sie sind natürlich für die Kommunikation im Web optimiert.

Fazit: Stellen Sie sich REST-APIs als Marie Kondo der Daten vor. Sie nehmen und verwenden nur *genau* das, was sie brauchen. SOAP-APIs sind wie die Garage Ihres Nachbarn, die derzeit bis zum Rand mit Toilettenpapier gefüllt ist.

Verstehen verschiedener Arten von APIs

Unabhängig davon, welchem ​​Protokoll oder welchen Stilen eine API folgt, gibt es mehrere Arten von APIs, darunter:

• Offene APIs – Diese auch als öffentliche APIs bezeichneten Endpunkte sind für jeden Entwickler zugänglich und erlegen dem Benutzer in der Regel keine Einschränkungen auf. Normalerweise nehmen sie Spenden an.
• Partner-APIs – Dies sind APIs, die für die gemeinsame Verwendung konzipiert sind und auf die normalerweise nur über eine Art Marktplatz zugegriffen werden kann.
• Interne APIs – Dies sind interne Tools, die Unternehmen verwenden, um ihren Mitarbeitern zu helfen, effizienter zu arbeiten, oder um Mitarbeitern eine sicherere Möglichkeit zum Austausch von Daten/Informationen zu bieten.
• Zusammengesetzte APIs – Zusammengesetzte APIs sind eine Möglichkeit, API-Aufrufe zu konsolidieren, die verwandt sind, aber normalerweise einzelne API-Aufrufe erfordern würden.

Beispiele aus der Praxis für APIs

Es gibt jede Menge APIs in freier Wildbahn (einige zählen mehr als 15.000), die Benutzern den Zugriff auf verschiedene Anwendungen erleichtern. Nachfolgend finden Sie einige bemerkenswerte, die Ihnen helfen werden, den Umfang des API-Ökosystems zu verstehen.

Die Cocktail-DB

Angenommen, Sie besitzen einen lokalen Spirituosenladen und möchten auf Ihrer Website Cocktailrezepte anbieten. Sie könnten erwägen, die obige Cocktail-DB-API zu verwenden. All diese Daten (die Cocktailrezepte) existieren bereits auf dem Server eines anderen und können über die API ausgewertet werden.

Wenn ein Benutzer auf die Margarita-Rezepte (wohl der bessere Cocktail) klickt, stellen seine Server fest, dass dieses bestimmte Rezept es in JSON sendet, es wird von der Website abgeholt und in HTML und CSS geparst, um es in Ihrem Website-Browser darzustellen.

OpenWeatherMap

Das Hinzufügen eines Wetterabschnitts zu Ihrer Website ist ein sehr häufiger Anwendungsfall. Denken Sie an Skigebiete, Fahrradgeschäfte oder Reiseveranstalter. Die OpenWeatherMap-API speichert alle Wettervorhersagen und Informationen und zeigt nur den Teil an, den Sie anfordern.

Diese API bietet sowohl kostenlose als auch Premium-Versionen, je nachdem, wie viele Daten Sie anzeigen möchten.

SendGrid-E-Mail-API

Die SendGrid-E-Mail-API nutzt SMTP (Simple Mail Transfer Protocol), um es Kunden zu ermöglichen, große Mengen an Transaktions- und getriggerten E-Mails zu senden – denken Sie an Passwortzurücksetzungen, Kontobestätigungen und Versandbenachrichtigungen.

Twilio-SMS

Die Twilio SMS-API ist eine weitere REST-API, die eine Möglichkeit bietet, Messaging-Funktionen zu Anwendungen hinzuzufügen. SMS-Nachrichten werden für Marken immer beliebter, um mit Kunden zu kommunizieren, da sie persönlich und in Echtzeit erfolgen und diese Nachrichten mit viel höheren Raten gelesen werden.

So verwenden Sie eine API

Bevor Sie oder Ihr Team mit der Verwendung von APIs beginnen, ist es wichtig zu wissen, ob sie offen sind, in Verbindung mit einem Partnerdienst verwendet werden oder zusammengesetzt sind.

Erste Schritte mit einer API

Lesen Sie die Dokumentation. Jede API sollte über eine entsprechende Dokumentation verfügen, der Sie folgen können. Es wird Ihnen sagen, welche Abhängigkeiten Sie haben, um welchen API-Typ es sich handelt und wie Sie es verwenden. Eine schlechte Dokumentation sollte für Sie und Ihren Entwickler ein Warnsignal sein. Wir sind ziemlich stolz auf die hervorragende Dokumentation von Twilio und SendGrid.

Generieren Sie einen API-Schlüssel. Sie müssen einen API-Schlüssel generieren, um ihn verwenden zu können. Hier sind Anweisungen von der Google Maps-API:

Hinweis : Teilen Sie niemals API-Schlüssel und stellen Sie sicher, dass sie in keinem öffentlichen Code, den Sie auf GitHub veröffentlichen, sichtbar sind.

Beginnen Sie mit dem Aufbau: Senden Sie kostenlos E-Mails mit der SendGrid-E-Mail-API

Der Rest liegt an dir! Die Möglichkeiten sind wirklich endlos, wenn Sie mit APIs arbeiten. Einen Blick auf alle Möglichkeiten, mit der Twilio-API zu arbeiten, finden Sie im Twilio Code Exchange.

Wenn Sie daran interessiert sind, die SendGrid-E-Mail-API zum Senden kostenloser E-Mails zu verwenden, sehen Sie sich das hier an.