Zum Inhalt springen

API-Integration

Alle Abfuhrdaten stehen über eine offene HTTP-API zur Verfügung. Die API ist die Grundlage jeder Integration – nutze sie direkt in deinen eigenen Anwendungen, Skripten oder Smart-Home-Systemen.

Endpunkt

Der zentrale Endpunkt liefert alle Abfuhrtermine für eine Adresse – gruppiert nach Abfallart – als JSON zurück. Es ist derselbe Endpunkt, der auch in der openHAB-Integration verwendet wird:

POSThttps://binable.app/api/fetch

Methode: POST · Antwort: JSON · Ein API-Schlüssel ist optional – anonyme Anfragen sind möglich, unterliegen aber ggf. strengeren Rate-Limits.

Mit einem API-Schlüssel erhältst du höhere Rate-Limits. Füge dazu einfach den Header Authorization: ApiKey <dein-schlüssel> hinzu. Kostenlos API-Key anfordern

Adresse übergeben

Die Adresse kann auf drei verschiedene Arten übergeben werden – wähle die, die am besten zu deinem System passt.

Verwendet werden die folgenden Felder: street, houseNumber, zip, city und country (ISO-3166-1-alpha-2-Ländercode, z. B. DE).

Query-Parameter

Hänge die Adressfelder an die URL an (Umlaute/Sonderzeichen müssen URL-kodiert werden):

https://binable.app/api/fetch?street=Musterstra%C3%9Fe&houseNumber=1a&zip=12345&city=Musterstadt&country=DE

HTTP-Header

Übergib die Adresse über X-Address-*-Header – so macht es auch die openHAB-Integration. Hinweis: keine Umlaute/Sonderzeichen in Headern, schreibe z. B. "ue" statt "ü".

X-Address-Street: Musterstrasse
X-Address-HouseNumber: 1a
X-Address-Zip: 12345
X-Address-City: Musterstadt
X-Address-Country: DE

JSON-Body

Sende die Adresse als JSON-Objekt im Request-Body:

{
  "street": "Musterstraße",
  "houseNumber": "1a",
  "zip": "12345",
  "city": "Musterstadt",
  "country": "DE"
}

Beispiel: curl-Aufruf

Ein vollständiger Aufruf mit JSON-Body sieht so aus:

curl -X POST https://binable.app/api/fetch \
  -H "Content-Type: application/json" \
  -d '{
    "street": "Musterstraße",
    "houseNumber": "1a",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  }'

Derselbe Aufruf mit API-Schlüssel:

curl -X POST https://binable.app/api/fetch \
  -H "Authorization: ApiKey <dein-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"street":"Musterstraße","houseNumber":"1a","zip":"12345","city":"Musterstadt","country":"DE"}'

← Übersicht der Integrationen  ·  Vollständige API-Dokumentation