Neue Beta-API für die Ausgabe von Onlinediensten innerhalb eines Gebietes
Mit dem PVOG Release 9.15. wurde für den Suchdienst der neue Endpunkt /v1beta2/onlineservices veröffentlicht.
Der Endpunkt liefert Onlinedienste innerhalb des angefragten ARS-Bereichs. Die Filterung erfolgt entlang der ARS-Hierarchie sowohl nach oben als auch nach unten.
Filterung nach oben: Bei der Suche nach der ARS 091 (Oberbayern) werden Onlinedienste mit Zuständigkeit für 091 sowie für übergeordnete Ebenen geliefert, z.B. Bayern (09) oder Bund (00).
Filterung nach unten: Bei der Suche nach 091 werden zusätzlich Onlinedienste für untergeordnete Ebenen bis hinunter zur Gemeindeebene geliefert, z.B. München (091620000000).
Beispiele zu den Ergebnissen der Abfrage
- Abfrage mit <= 1000 Ergebnisse Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=100
Für die ARS 100 werden im ersten Schritt alle Ergebnisse der Abfrage (725 hits) der insgesamt 725 Ergebnisse (totalHits) angezeigt.
- Abfrage mit > 1000 Ergebnissen Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090
Für die ARS 090 werden im ersten Schritt der Abfrage 1000 Ergebnisse (hits) der insgesamt 1590 Ergebnisse (totalHits) angezeigt.
Die weiteren Onlinedienste können durch das Setzen des „nextPageToken“ abgefragt werden.
Beispiel:
Einschränkung über Leika
Als weiterer Parameter kann in der Abfrage die Ergebnismenge auf eine Leistung aus dem Leistungskatalog eingeschränkt werden. Das Ergebnis sind die Onlinedienste, die für eine Leistung mit dem konkreten Leistungsschlüssel, zuständig sind.
https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090&leikaIds=99050012104000
Response
Antwortschema
Das Schema der Antwort ist auf dem Produktportal abgebildet und ermöglich die gezielte Weiterverarbeitung der Ergebnisse.
Parallel zum Produktportal kann auch die Swagger Dokumentation zum Ausprobieren verwendet werden.
Geben Sie gern Feedback zur vorgestellten beta API, z. b. in der User Group oder über das Helpdesk-Formular auf dem PVOG Produktportal!