Webservice: Unterschied zwischen den Versionen

(Die Seite wurde neu angelegt: „Ein '''Webservice''' ist eine Programmfunktion zur Bereitstellung von Schnittstellen über das HTTP-Protokoll. Um die Programmfunktion nutzen zu können…“)
Markierung: 2017-Quelltext-Bearbeitung
 
Markierung: 2017-Quelltext-Bearbeitung
 
(9 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Ein '''Webservice''' ist eine [[Programmfunktion]] zur Bereitstellung von Schnittstellen über das HTTP-Protokoll.
Ein '''Webservice''' ist eine [[Programmfunktion]] zur Bereitstellung von Schnittstellen über das HTTP-Protokoll.


== Voraussetzungen ==
Um die Programmfunktion nutzen zu können
Um die Programmfunktion nutzen zu können


* muss der [[Intern:ALEX-Config-File-AddOns#httpServicePlugins|Webservice-Daemon]] konfiguriert sein.
* muss der [[Intern:ALEX-Config-File-AddOns#httpServicePlugins|Webservice-Daemon]] konfiguriert sein.
* muss ein gültiger [[ALEX-Ports#.22httpServer.22_.22port.22_.3D_WebApi-Port|WebApi-Port]] konfiguriert sein.
* muss ein gültiger [[ALEX-Ports#httpServer.port_.3D_WebApi-Port|WebApi-Port]] konfiguriert sein.
* kann ein Zertifikat zur [[Verschlüsselung]] verwendet werden.
* kann ein Zertifikat zur [[Verschlüsselung]] verwendet werden.
* kann ein [[Webservice_Authorization|Sicherer Link-Aufruf]] konfiguriert werden.
* kann ein [[Webservice_Authorization|Sicherer Link-Aufruf]] konfiguriert werden.


Das Webservice stellt dann Zugriffspfade an der konfigurierten [[ALEX-Ports#Netzwerkadresse_.2B_Port|Webservice-Adresse]] zur Verfügung.
Das Webservice stellt dann Zugriffspfade an der konfigurierten [[ALEX-Ports#Netzwerkadresse_.2B_Port|Webservice-Adresse]] zur Verfügung.
Der Bediener des Webservice muss mit dem '''HTTP-Protokoll''' und seinen '''Möglichkeiten zur Argumentübertragung'''<ref name="refHTTP1">https://www.w3schools.com/tags/ref_httpmethods.asp</ref><ref name="refHTTP2">https://de.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Argument%C3%BCbertragung</ref> vertraut sein.
Der Bediener muss das Format der Anfrage und Ausgabe kennen.
== http-client-example ==
[https://github.com/bitfactory-software/http-client-example Sourcecode]
Dieses Beispielprogramm in HTML und JavaScript dient zur Veranschaulichung der Bedienung eines {{Alex}}-Webservice.
Mit diesem Beispielprogramm kann
* ein HTTP-GET Request an ein Webservice gesendet werden (Body-Eingabefeld bleibt leer)
* ein HTTP-POST Request an ein Webservice gesendet werden (Body-Eingabefeld ist gefüllt)
* ein API-Key gesendet werden
Im Response-Ausgabefeld wird das Ergebnis des Aufrufs angezeigt.
Mit diesem Beispielprogramm können alle {{Alex}}-Webservices bedient werden.
{{AlexBild|http-client-example|[[Datei:Webservice 1677590974711.png|300px]]}}
== Fußnoten ==
[[Kategorie:Webservice]]
[[Kategorie:Schnittstellen]]

Aktuelle Version vom 31. Oktober 2024, 11:05 Uhr

Ein Webservice ist eine Programmfunktion zur Bereitstellung von Schnittstellen über das HTTP-Protokoll.

Voraussetzungen

Um die Programmfunktion nutzen zu können

Das Webservice stellt dann Zugriffspfade an der konfigurierten Webservice-Adresse zur Verfügung.

Der Bediener des Webservice muss mit dem HTTP-Protokoll und seinen Möglichkeiten zur Argumentübertragung[1][2] vertraut sein.

Der Bediener muss das Format der Anfrage und Ausgabe kennen.

http-client-example

Sourcecode

Dieses Beispielprogramm in HTML und JavaScript dient zur Veranschaulichung der Bedienung eines Alex®-Webservice.

Mit diesem Beispielprogramm kann

  • ein HTTP-GET Request an ein Webservice gesendet werden (Body-Eingabefeld bleibt leer)
  • ein HTTP-POST Request an ein Webservice gesendet werden (Body-Eingabefeld ist gefüllt)
  • ein API-Key gesendet werden

Im Response-Ausgabefeld wird das Ergebnis des Aufrufs angezeigt.

Mit diesem Beispielprogramm können alle Alex®-Webservices bedient werden.

http-client-example
Webservice 1677590974711.png

Fußnoten