Simple Object Access Protocol Application Programming Interface Was ist eine SOAP API?

Anbieter zum Thema

DataCore Software GmbH

Impossible Cloud GmbH

Eine SOAP API ist eine Anwendungsprogrammierschnittstelle, die auf dem Simple Object Access Protocol basiert. SOAP nutzt die Auszeichnungssprache XML für den Austausch strukturierter Informationen. Über die API können verschiedene Anwendungen in einer verteilten Umgebung miteinander kommunizieren.

Ausgeschrieben bedeutet das Kürzel SOAP API „Simple Object Access Protocol Application Programming Interface“.

Bei einer SOAP API handelt es sich um eine Anwendungsprogrammierschnittstelle, die auf dem Simple Object Access Protocol basiert. SOAP ist ein standardisiertes Protokoll für die Kommunikation und den Informationsaustausch von Anwendungen in verteilten Umgebungen. Es kann sowohl in lokalen Netzwerken als auch im Internet verwendet werden. SOAP ist im TCP/IP-Protokollstapel auf der Anwendungsebene angesiedelt und plattform- und sprachunabhängig einsetzbar. Standardisiert ist das Protokoll vom World Wide Web Consortiums (W3C).

Über eine SOAP API können verschiedene Anwendungen in Netzwerkumgebungen miteinander kommunizieren. Typischer Einsatzbereich ist die Anbindung von Webservices.

Merkmale und Funktionsweise einer SOAP API

SOAP nutzt zur Repräsentation und Strukturierung der Daten die Auszeichnungssprache XML (Extensible Markup Language). Für den Transport der Daten verwendet SOAP üblicherweise HTTP (bzw. HTTPS) und TCP. Es sind aber auch andere Transportprotokolle möglich.

Eine SOAP API nimmt SOAP-Nachrichten als XML-Dokumente entgegen. Die Informationen einer SOAP-Nachricht sind in einem Envelope zusammengefasst. Der Envelope strukturiert die Nachricht und bildet den Container für Header und Body der Nachricht. Das erste Element im Envelope ist der Header. Er enthält Metainformationen der SOAP-Nachricht, zum Beispiel zur Verschlüsselung oder zum Routing. Der Header ist ein optionales Element und muss nicht zwingend vorhanden sein.

Im nachfolgenden Body sind die eigentlichen Informationen enthalten, die über die SOAP API übermittelt werden sollen. Der Body kann zum Datenaustausch, aber auch zur Übermittlung von Anweisungen zu einem Remote-Prozeduraufruf genutzt werden. Der Empfänger der SOAP-Nachricht verarbeitet und beantwortet die erhaltenen Daten oder Anweisungen und macht gegebenenfalls auf Fehler aufmerksam. Als Antworten werden über die API ebenfalls SOAP-Nachrichten als XML-Dokumente zurückgegeben.

Abgrenzung zur REST API

Neben der SOAP API gibt es weitere Schnittstellen für den Informationsaustausch zwischen Anwendungen. In verteilten Umgebungen kommt häufig die sogenannte REST API zum Einsatz. Sie wird auch als RESTful API bezeichnet. REST steht für „Representational State Transfer“. Während SOAP ein standardisiertes Protokoll ist, handelt es sich bei REST um ein Software-Architekturprinzip für verteilte Systeme. Auch REST verwendet in der Regel HTTP. Als Nachrichtenformate lassen sich verschiedene Formate wie XML, HTML, JSON oder einfacher Text nutzen.

REST APIs und SOAP APIs haben jeweils spezifische Vor- und Nachteile. Die REST API gilt als flexibler, schlanker und moderner. Sie ist zudem einfacher zu implementieren. SOAP hingegen hat in puncto Sicherheit, Zuverlässigkeit und Transaktionsunterstützung Vorteile. Typische Anwendungsbereiche der REST API sind mobile Apps, Serverless Computing und schlanke Webservices.

(ID:50157232)