demokratie-live / bt-dip-sdk

Dokumentations- und Informationssystems für Parlamentsmaterialien (DIP) – Bundestag – TypeScript Client
https://demokratie-live.github.io/bt-dip-sdk/
Apache License 2.0
5 stars 1 forks source link

Add new function for recently added documents #6

Closed hejjoe closed 7 months ago

hejjoe commented 1 year ago

"2.6 Anfrage kürzlich aktualisierter Entitäten"

Der Zeitpunkt der letzten Aktualisierung einer Entität wird im Feld aktualisiert ausgegeben. Eine Entität gilt als aktualisiert, wenn entweder diese selbst oder eine direkt verknüpfte Entität geändert wurde. So führen beispielsweise Änderungen an einer Vorgangsposition auch zur Aktualisierung des zugehörigen Vorgangs. Eine Aktualisierung bedeutet jedoch nicht unbedingt, dass sich die Felder einer Entität tatsächlich geändert haben. Mittels des Anfrageparameters f.aktualisiert.start können Entitäten selektiert werden, die seit dem angegebenen Datum aktualisiert wurden. Beispiel: Alle Vorgänge, die seit dem 24.06.2022, 9:00 Uhr aktualisiert wurden https://search.dip.bundestag.de/api/v1/vorgang?f.aktualisiert.start=2022-06-24T09:00:00&apikey=GmEPb1B.bfqJLIhcGAsH9fTJevTglhFpCoZyAAAdhp Sollen die Aktualisierungen der DIP-Datenbank regelmäßig angefragt werden, ist zu beachten, dass es einen Zeitversatz von ca. 10-15 Minuten gibt, bis eine Änderung in der API sichtbar ist. Um keine Aktualisierungen zu verpassen, sollten sich die angefragten Intervalle entsprechend überlappen. Beispiel: Stündliche Anfrage von aktualisierten Vorgängen mit zeitlicher Überlappung • 10:00 Uhr: https://search.dip.bundestag.de/api/v1/vorgang?f.aktualisiert.start=2022-06-24T08:50:00&apikey=GmEPb1B.bfqJLIhcGAsH9fTJevTglhFpCoZyAAAdhp • 11:00 Uhr: https://search.dip.bundestag.de/api/v1/vorgang?f.aktualisiert.start=2022-06-24T09:50:00&apikey=GmEPb1B.bfqJLIhcGAsH9fTJevTglhFpCoZyAAAdhp • 12:00 Uhr: https://search.dip.bundestag.de/api/v1/vorgang?f.aktualisiert.start=2022-06-24T10:50:00&apikey=GmEPb1B.bfqJLIhcGAsH9fTJevTglhFpCoZyAAAdhp

https://dip.bundestag.de/documents/informationsblatt_zur_dip_api.pdf

ManAnRuck commented 7 months ago

Da das SDK nun direkt vom OpenAPI YAML generiert wird, sollten die Änderungen dort nun auch zur verfügung stehen :)

Danke für die Erweiterung der Bundestags API und für den Hinweis das hier mit zu implementieren ❤️