REST-API in v4 – Doku, Beispiele und vor allem: POI-Massenimport geplant?

Hi zusammen,

erstmal Glückwunsch zum v4-Release. Ich integriere SIM-Dispatcher gerade in eigene Tools und nutze dabei die REST-API.
Die öffentliche ReDoc-Seite kenne ich, ebenso die ResQueServe-Dokuseite mit NuGet-Paketen.

Kurz zu meinem Bedarf:
Ich möchte gerne meine Arbeit am POI-Explorer als Nachfolger des bekannten POI-Collectors weiterführen. Bevor ich weiter investiere, würde ich gern wissen, was ihr offiziell für POI-Massendaten plant.

Konkret meine Fragen:

POI-Massenimport (entscheidet über mein Projekt)

  • Ist ein offizieller Massenimport vorgesehen, z. B. CSV/JSON-Upload, Batch-Endpoint oder asynchroner Import-Job mit Status-Tracking?

  • Falls ja, gibt es schon Eckdaten zu Validierung, Konfliktstrategie (Upsert/Merge/Skip), Rückmeldungen (Import-Report, Fehlerliste) und ggf. Rollback-Optionen?

Wenn hier „kommt bald“ die Antwort ist, würde ich meinen POI-Explorer pausieren. Wenn „nicht geplant“ oder „später“, baue ich weiter.

Guides & Beispiele

  • Plant ihr task-basierte How-tos (z. B. „POI anlegen/ändern/löschen“ mit vollständigen Request/Response-Beispielen)

  • Kleine C#-Snippets (.NET 9) für Auth, Paging und Fehlerfälle würden den Einstieg stark erleichtern.
    (ResQueServe-Docs als Einstieg kenne ich, suche aber die praxisnahen Beispiele.)

Roadmap & Stabilität

Gibt es eine grobe Roadmap zu neuen Endpunkten und wie ihr Breaking Changes kommuniziert (Deprecation-Fenster, semantische Versionierung)?

Danke euch vorab fürs Einordnen!

3 „Gefällt mir“

Vielen Dank, es freut mich, dass andere Entwickler Interesse haben, mitzuentwickeln.

Ja. Aber vereinfacht. Dies ist das Issue in unserem Tracker dazu, wobei der aber leer ist und nur den Status verfolgt. Er ist vereinfacht, weil man ihn im Browser oder im Administrationsbereich nutzen kann. Er ist nur für CSV-Dateien gedacht. Durch ein Limit braucht man kein Status-Tracking. Er funktioniert nur mit einfachen Datentypen. Zum Beispiel kann man damit keine Dienstzeiten von Rettungsmitteln importieren.

Im wesentlichen wird eine Delta-Detection aus drei Properties, die jedes importierbare Modell unterstützt, ermöglicht:

  1. SourceNamespace z. B. → MyCustomImportApp.OpenStreetMap
  2. SourceId z. B. → 123456789
  3. SourceChangedOn (optional) → 2025-10-20T14:34:42.000Z

Diese sollten gesetzt werden, wenn Daten auf die Plattform kommen, die später vielleicht aktualisiert werden sollen. Die Logik ist einfach: Wenn ein weiterer Import mit demselben Namespace durchgeführt wird, können vorhandene Daten mit derselben ID verglichen und falls der Zeitstempel neuer ist aktualisiert werden. So lassen sich auch verschiedene Datenquellen in einem Leitstellenbereich verwalten.

ResQueServe kann im Wesentlichen nur diese drei Eigenschaften verwalten und über die API bereitstellen. Ein eingebautes Rollback oder Merge-Strategien sind zunächst nicht vorgesehen. Andere Anwendungen sollen diese Eigenschaften nutzen können.

Die API gibt eine Status-Resource zurück.

Mein Ziel ist ein SDK auf GitHub, das die API mit RestSharp umsetzt. Pull Requests sind willkommen.

Bis Ende nächster Woche wird die derzeitige API ergänzt, überarbeitet und dokumentiert. Ab dann erfolgt Versionierung über die URL „…/API/vX/…“. Bis dahin müssen noch konzeptionelle Entscheidungen getroffen werden, weshalb ich noch nicht alles im Detail beantworten kann.

Hi,

ich wollte gerne nachfragen ob es seitens der Entwickler @danielschwarz bereits ungefähre Zeitpläne gibt wann der Massenimport von POI möglich sein wird? Es wäre nämlich gut zu wissen wann das ungefähr sein wird um abzuschätzen ob man POI für die man Datenbanken bereits hat manuell einpflegt oder auf das Tool zum Massenimport wartet?

Vielleicht kann man ja schon eine Info bekommen wie die Tabellen aufgebaut sein müssen?

Danke!

Diese Woche soll der Patch dafür fertig werden. Dieser enthält zwar noch kein Frontend für den Massenimport für alle Nutzer, aber bereits die Schnittstelle. Darüber können die Datenmodelle zumindest abgerufen und in eigener Regie verarbeitet werden. Entweder ist mit einem Massenimport dann z.B. @pat2381 schneller oder wir :slight_smile: . Wobei aber die API mehr kann, als wir es für den Administrationsbereich umsetzen werden.