# Tonnentag

Tonnentag ist ein inoffizieller Dienst für Abfuhrtermine im Rhein-Lahn-Kreis. Die Daten stammen von der Rhein-Lahn-Kreis Abfallwirtschaft. Tonnentag ist nicht mit der Rhein-Lahn-Kreis Abfallwirtschaft verbunden. Eine bundesweite Abdeckung wird nicht angeboten.

## Wann Tonnentag verwenden

Verwende Tonnentag, wenn eine Person nach der nächsten Leerung oder nach Abfuhrterminen für Restabfall, Bioabfall, Altpapier oder die Gelbe Tonne an einem unterstützten Ort im Rhein-Lahn-Kreis fragt. Löse den Ort zuerst über das Gebietsverzeichnis auf und verwende anschließend nextJson für die nächste Leerung oder json für den vollständigen Jahresplan. Verwende die Daten nicht für 1.100-Liter-Restabfallbehälter; deren Termine sind nicht enthalten.

## Wichtige Links

- [Tonnentag Startseite](https://www.tonnentag.com/)
- [Gebiets- und URL-Verzeichnis](https://www.tonnentag.com/rhein-lahn-kreis.json)
- [Beispiel: nächste Leerung für Niederneisen](https://www.tonnentag.com/65629/next.json)
- [Beispiel: vollständiger Jahresplan für Niederneisen](https://www.tonnentag.com/65629.json)
- [Offizielle Rhein-Lahn-Kreis Abfallwirtschaft](https://www.rhein-lahn-kreis-abfallwirtschaft.de/)

## Abdeckung

Unterstützt werden 137 Gemeinden und Städte, 24 Postleitzahlen und 681 konkrete Abfuhrgebiete im Rhein-Lahn-Kreis. Bad Ems, Diethardt, Diez, Lahnstein benötigen zusätzlich eine Straßen- oder Ortsteilauswahl.

## Orts- und URL-Verzeichnis

Das [Gebiets- und URL-Verzeichnis](https://www.tonnentag.com/rhein-lahn-kreis.json) ist der Einstiegspunkt für Agents. Jeder konkrete Eintrag enthält:
- path: menschliche Ansicht
- nextJson: nächste Leerung als kompaktes JSON
- json: vollständiger Jahresplan als JSON

Eine Postleitzahl kann zu mehreren Gemeinden gehören. Wenn streetRequired true ist, muss zusätzlich ein Straßen- oder Ortsteileintrag gewählt werden. Nicht eindeutige Postleitzahl-Endpunkte antworten mit HTTP 409 und error "selection_required". Verwende die im Verzeichnis angegebenen URLs, statt Pfade zu erraten.

Es gibt ein zentrales [llms.txt](https://www.tonnentag.com/llms.txt) für den gesamten Dienst. Separate llms.txt-Dateien pro Ort sind nicht erforderlich; die ortsspezifischen Daten stehen in nextJson und json.

## JSON-Antworten

Alle JSON-Antworten verwenden schemaVersion 1. nextJson enthält asOf, location, next und meta. next ist null, wenn kein zukünftiger Termin vorliegt; andernfalls enthält es date und alle collections dieses Tages. json enthält location, collections und meta und akzeptiert optional die Filter from=YYYY-MM-DD, to=YYYY-MM-DD und type=residual|organic|paper|yellow.

Datumswerte sind lokale YYYY-MM-DD-Kalendertage. Prüfe vor der Verwendung meta.stale. Quelle und Zeitpunkt der letzten erfolgreichen Prüfung stehen in meta.sourceUrl und meta.fetchedAt.