Skip to content

Test der neuen API-Version des PVOG

User Story

Der Routingdienst nutzt Enpunkte der PVOG-Suchdienst-API. Der Wechsel auf neue Versionen soll möglichst reibungslos ablaufen.

Warum

Das PVOG-Team befindet sich gerade in einer Testphase zur Umsetzung des neuen XZuFi 2.3.1 Standards und benötigt Umterstützung beim Testen der neuen Endpunkte.

Links, Hinweise, Bemerkungen

Wir befinden uns gerade in einer Testphase zur Umsetzung des neuen XZuFi 2.3.1 Standards. Hierfür haben wir eine sogenannte Preview-Umgebung aufgebaut. Darin enthalten sind Daten aus Baden-Württemberg, Sachsen (jeweils im 2.2 Format) und Hamburg (im 2.3.1 Format). Zur Unterstützung des neuen Formats haben wir jeweils eine neue Version der von ihnen genutzten Endpunkte bereitgestellt:

  • /v3/servicedescriptions/jzufi
  • /v3/relations/{ars}/jzufi
  • /v2/organisationunits/jzufi

Die Swagger zu den jeweiligen Endpunkten finden Sie hier: https://public.test-preview.rke2.pvog.dataport.de/suchdienst/api/swagger-ui/index.html#/ Wenn Sie die Endpunkte wie gewohnt nutzen (also ohne zusätzliche Angabe des Headers) bekommen Sie die Daten wie bisher im 2.2 Format. Wenn Sie wie in der Swagger beschrieben im Header den Abruf im 2.3.1 Format anfordern, bekommen Sie die „echten“ 2.3.1 Daten aus Hamburg und konvertierte Daten aus Baden-Württemberg und Sachsen. Wir würden uns freuen, wenn Sie sich die Zeit nehmen könnten die neuen Endpunkte zu testen. Wichtig wären uns folgende Erkenntnisse:

  • Sind die Daten die Sie erhalten für Sie so verwendbar? Werden die fachlichen Daten so geliefert wie erwartet?
  • Treten unerwartete Fehler an der API auf, die mit einem http-Status 400 oder 500 quittiert werden?
  • Treten Timeouts auf?
  • Benötigen Anfragen unerwartet lange, bis diese beantwortet wurden?

Akzeptanzkriterien

  1. Es ist geklärt, ob auch im neuen Format alle vom Routingdienst benötigten Daten enthalten sind.
  2. Es wurde ein grober Überblick gewonnen, ob bzw. in welchem Umfang für das neue Format Anpassungen beim Routingdienst erforderlich sind.
  3. Ggf. seitens des PVOG auftretende Fehler, Timeouts und Performance-Schwächen sind mit allen für die Fehlerbehebung relevanten Informationen dokumentiert.

Mögliche Folgeaktivitäten (vom Entwickler zu ergänzen)