jschibberges / Bundestag-API

A python-wrapper for the official Bundestag (German Federal Parliament) API
MIT License
5 stars 1 forks source link

Add new function for recently added documents #3

Closed hejjoe closed 5 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

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

see also: https://search.dip.bundestag.de/api/v1/swagger-ui/

jschibberges commented 8 months ago

Functionality is coming soon.