Preskoči na vsebino

Integracija API

Vsi podatki o odvozu odpadkov so na voljo prek odprtega API HTTP. API je temelj vsake integracije – uporabite ga neposredno v svojih aplikacijah, skriptah ali sistemih pametnega doma.

Končna točka

Osrednja končna točka vrne vse termine odvoza za naslov, razvrščene po vrsti odpadkov, kot JSON. To je ista končna točka, ki se uporablja v integraciji openHAB:

POSThttps://binable.app/api/fetch

Metoda: POST · Odgovor: JSON · Ključ API je neobvezen – anonimni zahtevki so mogoči, vendar so lahko strožje omejeni.

S ključem API dobite višje omejitve. Preprosto dodajte glavo Authorization: ApiKey <vaš-ključ>. Pridobite brezplačen ključ API

Posredovanje naslova

Naslov je mogoče posredovati na tri različne načine – izberite tistega, ki vašemu sistemu najbolj ustreza.

Uporabljena so naslednja polja: street, houseNumber, zip, city in country (dvočrkovna koda države ISO 3166-1 alpha-2, npr. DE).

Poizvedbeni parametri

Polja naslova dodajte na URL (preglasi/posebni znaki morajo biti kodirani za URL):

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

Glave HTTP

Naslov posredujte prek glav X-Address-* – to uporablja integracija openHAB. Pozor: brez preglasov/posebnih znakov v glavah, namesto „ü“ pišite „ue“.

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

Telo JSON

Naslov pošljite kot objekt JSON v telesu zahtevka:

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

Primer: klic curl

Popoln klic s telesom JSON izgleda tako:

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

Isti klic s ključem API:

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"}'
MCP
Termini odvoza za AI-pomočnike, kot je Claude
Webhook
Samodejno posredujte termine odvoza na svoj URL
n8n
Avtomatizirajte termine odvoza v delovnih tokovih

← Pregled integracij  ·  Celotna dokumentacija API