search

europace / baufismart-vorgaenge-api

Dokumentation der Vorgänge API
https://docs.api.europace.de/baufinanzierung/vorgaenge/vorgang-auslesen-api/
Apache License 2.0
7 stars 5 forks source link

Vorgänge mehr Daten zuweisen #40

Open Fruchtgummi opened 5 years ago

Fruchtgummi commented 5 years ago

Wenn ich https://baufismart.api.europace.de/v2/vorgaenge?datenKontext=TEST_MODUS anspreche, bekomme ich folgendes zurück:

{ "datenKontext": "TEST_MODUS", "vorgangsNummer": "NY1467", "letztesEreignis": "2016-02-23T09:05:25.924Z", "letzteAenderung": "2016-02-23T09:05:25.912Z", "_links":{"self":{"href": "https://baufismart.api.europace.de/v2/vorgaenge/NY1467"…} }

Wie bekomme ich den mehr Informationen? Titel usw...

caspii commented 5 years ago

Pro Vorgang im Response wird ein Link angegeben, mit dem alle Daten zum Vorgang abgerufen werden können. Du musst also Durch die Liste iterieren und jeden Vorgang abholen.

In deinem Beispiel ist der erste Link https://baufismart.api.europace.de/v2/vorgaenge/NY1467

Fruchtgummi commented 5 years ago

Mit Verlaub! Wir leben im Jahre 2019 und es gibt Sprachen wie QL und so ein Pfeffer, da bestimmt man mit einem Call was man zurück haben möchte. Ich hole mir hier eine Liste, dann range ich diese Liste durch, mache pro Zeile einen neuen Request und baue mir mit jeden einzelnen Response selbst mein Array, das ich mir dann zurück gebe?

Wer das da bei Euch Design-Technisch entschieden hat, müsste man kündigen!

caspii commented 5 years ago

Unsere APIs sind als Backend-APIs gedacht. Sprachen wir GraphQL bedienen in erste Linie Fälle, wo Datensparsamkeit die höchste Priorität haben. Es ist durchaus denkbar, dass wir das in Zukunft ermöglichen.

Den API Designer werden wir, deinem Rat folgend, zeitnah kündigen.

Fruchtgummi commented 5 years ago

"...GraphQL bedienen in erste Linie Fälle, wo Datensparsamkeit die höchste Priorität haben"

In Deutschland, im Deutschen Netz, muss das immer hohe Priorität haben. Und es geht hier nicht um Datensparsamkeit sondern um Latenz, um Services. Schon die Tatsache das ihr 9 Tage gebraucht habt hier eine Antwort zu formulieren, aber jetzt, weil jemand sich auf sein kleines Würstchen getreten fühlt, nur 38 min, und das an einem Samstag, drückt genau jenes aus, was ich meine...

"Den API Design werden wir, deinem Rat folgend, zeitnah kündigen." <- ergibt keinen sinn, und...

deswegen sollte man komplett das ganze Team auswechseln, weil kein anderer diesen Mist verhindert hat. Ihr braucht ein fähigen CTO, call me back...

bye bye...

caspii commented 5 years ago

Hallo @Fruchtgummi,

bitte beschreibe mir deinen Use-Case, damit ich verstehen kann, was Du erreichen möchtest. Ist es ein Mobile Use-Case oder ein Backend Use-Case?

Desweiteren wünsche ich mir, das du deinen Ton etwas anpasst. Wir freuen uns über Feedback, auch kritisches, und sind bemüht, unsere Kunden glücklich zu machen. Das uns das nicht immer gleich gelingt ist uns schmerzlich bewusst. Dennoch wünsche ich mir von unseren Kunden (und Kollegen!) einen respektvollen Austausch auf Augenhöhe. Das kann ich in dieser Diskussion bisher für mich nicht feststellen.

VG Caspar

dneukirchen commented 4 years ago

Es wäre wünschenwert, wenn GET /vorgaenge eine liste von Vorgaengen mit den resource details zurückgibt und nicht lediglich einen link zu den details.

Auch unsere app würde von einer solchen Änderung profitieren. Wir könnten uns einige api requests ersparen und die anwenderfreundlichkeit verbessern.

Zudem wäre es wünschenswert, wenn die Filter- und Sortierungsmöglichkeiten dieses endpunkts erweitert würden, so dass man bspw. nach Antragsstellern, Finanzierungsobjekten und weiteren feldern (status, phase, prio, ... hier ist sehr vieles denkbar) filtern und/oder sortieren kann.

caspii commented 4 years ago

@dneukirchen welche Resource-Details würdest Du dir den wünschen?

Bzgl Filter gerne ein neues Ticket erstellen

dneukirchen commented 4 years ago

Im optimalfall werden alle details ausgegeben, die auch beim aufruf der vorgangsdetails zurückgegeben werden. Also ein Array von Vorgängen

Alternativ wären folgende felder für uns von besonderer bedeutung (priorisiert):

Gerne kann die ausgabe weiterer details/felder auch über url parameter gesteuert werden: z.B.: GET /vorgaenge?include=haushalte,vohraben,status

Für die filter und sortierung habe ich https://github.com/europace/baufismart-vorgaenge-api/issues/43 aufgemacht.

KoneFuzius commented 4 years ago

@dneukirchen danke für das Feedback. Wir besprechen die Wünsche und Ideen in unserem Team...