Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Die gegenwärtige Version von veloconnect kennt vier zwei Bindungen:

  • URL (Nur bis Version 1.3)

  • URL-S (Nur bis Version 1.3)

  • XML-POST

  • XML-POST-S

Regel: Standard-URL

Ein veloconnect-konformer Server ist unter einer festgelegten Standard-URL zu erreichen. Diese wird dem Kunden (Käufer) zusammmen zusammen mit weiteren Zugangsparametern wie z.B. Benutzername und Passwort mitgeteilt. Die GetProfile-Operation wird unter der Standard-URL verarbeitet. Für alle anderen Operationen können abweichende URLs festgelegt sein, die Antwort auf einen GetProfile-Request enthält diese Informationen.

...

In der URL-Bindung wird die Anfrage als Folge von Parametern serialisiert, die gemäß des Medientyps application/x-www-form-urlencoded als Zeichenkette kodiert wird. Wie eine Anfrage als Folge von Parametern aufzufassen ist, wird jeweils bei den einzelnen Operationen angegeben. Zusätzlich kann zusätzlich zu den Operations-spezifischen Parametern der Parameter version verwendet werden. Zur Durchführung der Operation wird entweder vom Client mittels der GET-Methode die URL-Adresse angesteuert, die sich als Verkettung der zur Operation gehörigen URL, dem Zeichen "?" und den kodierten Parametern ergibt, oder der Client überträgt mittels der POST-Methode die kodierten Parameter an die zur Operation gehörige URL. Die Auswahl zwischen GET und POST bleibt dem Client überlassen; d.h. der Server muss beide Varianten implementieren, wenn er die URL-Bindung realisiert. Die Antwort wird als XML-Datei serialisiert und als Inhaltstyp application/xml zurückgeliefert. Die URL-S-Bindung unterscheidet sich von der URL-Bindung nur darin, dass an Stelle von HTTP/1.1 zur Übermittlung das Protokoll "HTTP over TLS" (https, rfc 2818) verwendet wird.

Note

Ab Version 1.4 wird nur noch die XML-POST-Bindung unterstützt. Die URL-Bindung fällt damit weg. D.h. dass für alle Module die in 1.4 und späteren Versionen hinzukommen sind nur noch mit der XML-POST-Bindung abrufbar.

Regel: XML-POST-Bindung

Bei der XML-POST-Bindung werden sowohl Anfrage als auch Antwort als XML-Datei serialisiert und als Inhaltstyp application/xml übertragen. Die Anfrage verwendet die POST-Methode des HTTP/1.1-Protokolls. Die XML-POST-S-Bindung unterscheidet sich von der XML-POST-Bindung nur darin, dass an Stelle von http zur Übermittlung das Protokoll https verwendet wird.

...