Repository navigation
Conversation
The year enum stopped at 2021 while the endpoint answers for 2012 to 2026. Checked on 2026-08-09: year=2012 and year=2026 both return 200, year=2011 and year=2027 return 404, so the enum now matches what the endpoint actually serves. The same host also serves static XML files that no README or spec mentions. They carry the line-item level the JSON response does not expose: haushalt_2026.xml parses to 26 Einzelplaene, 234 Kapitel and 6995 Titel. Those paths are described in the READMEs rather than in openapi.yaml, because they are not a guaranteed part of the API and may change at any time. Refs bundesAPI#2
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Setzt die ersten beiden Punkte aus #2 um. @anetz89 hatte dort geschrieben, dass wir gerne erweitern dürfen, deshalb hier ein konkreter Vorschlag statt weiterer Diskussion. Wenn euch die Form nicht passt, schmeißt gerne alles um oder macht daraus zwei getrennte PRs.
Bewusst nicht enthalten, weil beides eine Entscheidung von euch braucht:
detailstattdetailsim SchemaBudgetDataResponse. Das ändert einen veröffentlichten Vertrag, das gehört in einen eigenen PR, wenn ihr ihn wollt.bundeshaushalt.api.bund.dev. Die lässt sich nur in den Repo-Settings umlegen, per PR kommen wir da nicht ran.1. year-Enum auf 2012 bis 2026
Das Enum endete bei 2021, der Endpunkt antwortet aber weiter. Geprüft am 09.08.2026, jeder Jahrgang einzeln: 2012, 2021, 2022, 2023, 2024, 2025 und 2026 liefern jeweils 200, während 2011 und 2027 mit 404 antworten. Das Enum bildet damit genau das ab, was der Endpunkt liefert.
Falls ihr das lieber wartungsarm hättet, sagt Bescheid, dann ändern wir es auf
type: integermitminimum: 2012, dann muss niemand das Enum jedes Haushaltsjahr nachziehen.2. Statischer XML-Bestand im README
Auf demselben Host liegen statische XML-Dateien, die in README und Spezifikation bisher nicht vorkommen. Sie enthalten die Titelebene, die die JSON-Antwort so nicht ausgibt: haushalt_2026.xml enthält geparst 26 einzelplan, 234 kapitel und 6995 titel.
Dokumentiert ist das Pfadmuster für Soll, Ist, Regierungsentwurf und Nachtragshaushalte, jeweils mit dem Hinweis, dass nicht jede Kombination existiert und dass der Host www.bundeshaushalt.de sein muss, weil es ohne www. eine Weiterleitung gibt.
Das steht bewusst im README und nicht in der
openapi.yaml: es ist kein zugesicherter Endpunkt und kann sich jederzeit ändern. Wenn ihr es trotzdem lieber in der Spec hättet, ziehen wir es um.Geprüft
openapi.yamlundopenapi_en.yamlparsen beide weiter, das Enum ist sortiert und ohne Dubletten, und an den übrigen Parametern (quota, account, unit, id) ändert sich nichts. Beide Dateien waren vorher byteidentisch und sind es danach immer noch. Der generierte python-client ist absichtlich unberührt, den erzeugt ihr ja aus der Spec.Zur Lizenz: das Repo nennt keine, deshalb steht in den beigesteuerten Dateien auch keine. Sagt uns gerne, unter welcher Lizenz Beiträge hier laufen sollen.
Aufgefallen ist uns das beim Aufbau des KI-Haushaltsmonitors, der alle 13 Jahrgänge und 9 offizielle Revisionsstände durchspielt: https://i6eal.de/tools/ki-haushaltsmonitor/