Hoppa till innehåll

API-integration

All data om sophämtning är tillgänglig via ett öppet HTTP-API. API:et är grunden för varje integration – använd det direkt i dina egna applikationer, skript eller smarta hem-system.

Slutpunkt

Den centrala slutpunkten returnerar alla hämtningsdatum för en adress grupperade efter avfallstyp som JSON. Det är samma slutpunkt som används i openHAB-integrationen:

POSThttps://binable.app/api/fetch

Metod: POST · Svar: JSON · En API-nyckel är valfri – anonyma förfrågningar är möjliga men kan begränsas hårdare i antal.

Med en API-nyckel får du högre gränser. Lägg bara till headern Authorization: ApiKey <din-nyckel>. Skaffa gratis API-nyckel

Skicka adressen

Adressen kan skickas på tre olika sätt – välj det som passar ditt system bäst.

Följande fält används: street, houseNumber, zip, city och country (ISO 3166-1 alpha-2-landskod, t.ex. DE).

Frågeparametrar

Lägg till adressfälten i URL:en (omljud/specialtecken måste URL-kodas):

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

HTTP-headers

Skicka adressen via X-Address-*-headers – det är vad openHAB-integrationen använder. Obs: inga omljud/specialtecken i headers, skriv "ue" i stället för "ü".

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

JSON-body

Skicka adressen som ett JSON-objekt i förfrågans body:

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

Exempel: curl-anrop

Ett fullständigt anrop med en JSON-body ser ut så här:

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"
  }'

Samma anrop med en API-nyckel:

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"}'

← Översikt över integrationer  ·  Fullständig API-dokumentation