Durchgängiges Beispiel für Getting Started erstellen und nutzbar machen

Ziel: Um Getting Started besser für Entwickler Hands's on nutzbar zu machen, soll ein durchgängiger Beispielspieldatensatz genutzt werden, der für alle API-Aufrufe und technische Aufgaben (Schemavalidierung) genutzt werden kann. Dieser Beispieldatensatz besteht aus folgenden Bestandteilen:

Als Erweiterung könnte vorgesehen werden:

  • Den Metadatensatz und das SET auf Basis von Datenvorgaben selbst erstellen.

Akzeptanzkriterien:

  • Alle Beispieldaten liegen vor und können öffentlich runtergeladen werden
  • Beispiel wird durchgängig in Getting Started genutzt
  • Alle Schritte in der API können mit einem einfachen Tool (aka. CURL) umgesetzt werden
  • Die Validierungen des Fachdatensatzes und des Metadatensatzes können mit einem einfachen Tool wie ajv-cli (https://ajv.js.org/) durchgeführt werden. Validierungsschritte im Kontext des Tools sind beschrieben -> vgl. #3 (moved)
  • Fachdatensatz soll ein JSON Schema besitzen. Dies kann ein reelles FIM-Beispiel (Hundesteuer) sein, muss es aber nicht (kann auch ein X-beliebiges JSON Schema sein). Es sollte nur relativ einfach sein. XML oder speziell XÖV sollte nicht genutzt werden, da für die Validierung zusätzliches Tooling und Know-How gebraucht wird.
Edited by Marco Holz