Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- projekte:etermin:start [14.09.2026 15:34] – [Betrieb & Fehlersuche] hwehrs
+++ projekte:etermin:start [20.09.2026 22:18] (aktuell) – [Einleitung] hwehrs
@@ Zeile 20: / Zeile 20: @@
 wird ein neuer Interessent angelegt.
 </WRAP>
-----
 <WRAP tip round 80% justify>
@@ Zeile 34: / Zeile 32: @@
 **Teil 3 – Datenübergabe an PW**\\
 Wie wird geprüft, ob die Person bereits vorhanden ist, und was geschieht anschließend?
+</WRAP>
+<WRAP center 80%>
+<WRAP 80%>
+{{:projekte:etermin:teil-1-comic.png?direct|}}
+</WRAP>
 </WRAP>
@@ Zeile 66: / Zeile 70: @@
 <WRAP info round 80% justify>
-**Was bedeutet „Webhook“?**
+<wrap em>Was bedeutet „Webhook“?</wrap>
 Ein Webhook ist vereinfacht gesagt ein **digitaler Datenbote**. Sobald eine neue
@@ Zeile 366: / Zeile 370: @@
 und nicht vorab angenommen.
 </WRAP>
-----
 ----
@@ Zeile 377: / Zeile 379: @@
 Für die automatische Verarbeitung einer eTermin-Buchung werden zwei technisch
-unterschiedliche Schnittstellen verwendet.
+unterschiedliche Schnittstellen und Kommunikationswege verwendet.
 <wrap em>eTermin → unsere Datenschnittstelle</wrap>\\
@@ Zeile 383: / Zeile 385: @@
 Buchung sendet eTermin die vorgesehenen Buchungsdaten selbstständig an eine
 dafür bereitgestellte Adresse unserer Datenschnittstelle.
+Die Buchungsdaten werden dabei als **JSON-Datenblock** übertragen. Dieser enthält
+die von eTermin bereitgestellten Informationen zur Buchung und zur betreffenden
+Person.
 <wrap em>Unsere Datenschnittstelle ↔ Professional Works</wrap>\\
 Die weitere Kommunikation erfolgt über die **API von Professional Works**.
-Hierbei übernimmt unsere Datenschnittstelle die aktive Rolle: Sie stellt gezielte
+Unsere Datenschnittstelle übernimmt hierbei die aktive Rolle und stellt gezielte
-Anfragen an PW und verarbeitet die jeweiligen Antworten.
+HTTP-Anfragen an PW.
+Je nach benötigter Aktion werden insbesondere **GET-Anfragen** zum Abrufen bzw.
+Prüfen vorhandener Informationen und **POST-Anfragen** zur Übergabe neuer Daten
+bzw. zum Auslösen entsprechender Aktionen verwendet. Die Antworten von
+Professional Works werden anschließend von unserer Datenschnittstelle ausgewertet.
+<wrap em>Der Zwischenstopp auf unserer Datenschnittstelle ist deshalb technisch notwendig:</wrap>\\
+Der von eTermin gelieferte JSON-Datenblock kann nicht einfach unverändert an
+Professional Works weitergereicht werden. Die enthaltenen Daten müssen geprüft,
+den entsprechenden PW-Datenfeldern zugeordnet und bei Bedarf um technisch
+erforderliche Angaben ergänzt werden. Anschließend erzeugt unsere
+Datenschnittstelle daraus die jeweils benötigten HTTP-Anfragen an die
+Professional-Works-API.
-Die beiden Schnittstellen erfüllen damit unterschiedliche Aufgaben:
+Unsere Datenschnittstelle übernimmt damit nicht nur den Transport, sondern die
-Der **Webhook startet** den Vorgang, die **PW-API dient anschließend der
+**Übersetzung und kontrollierte Vermittlung zwischen zwei unterschiedlichen
-kontrollierten Verarbeitung der Kundendaten**.
+Schnittstellen**.
 </WRAP>
@@ Zeile 435: / Zeile 454: @@
 <wrap em>Webhook = eTermin meldet ein Ereignis. API = unsere Datenschnittstelle führt gezielte Aktionen mit Professional Works aus.</wrap>
 </WRAP>
-----
 <WRAP important round 80% justify>