Gå til indhold

API-integration

Alle afhentningsdata er tilgængelige via et åbent HTTP-API. API'et er grundlaget for enhver integration – brug det direkte i dine egne applikationer, scripts eller smart home-systemer.

Endepunkt

Det centrale endepunkt returnerer alle afhentningsdatoer for en adresse – grupperet efter affaldstype – som JSON. Det er det samme endepunkt, som bruges i openHAB-integrationen:

POSThttps://binable.app/api/fetch

Metode: POST · Svar: JSON · En API-nøgle er valgfri – anonyme forespørgsler er mulige, men kan være underlagt strengere rate limits.

Med en API-nøgle får du højere rate limits. Tilføj blot headeren Authorization: ApiKey <din-nøgle>. Få gratis API-nøgle

Angiv adressen

Adressen kan angives på tre forskellige måder – vælg den, der passer bedst til dit system.

Følgende felter anvendes: street, houseNumber, zip, city og country (ISO 3166-1 alpha-2-landekode, f.eks. DE).

Query-parametre

Tilføj adressefelterne til URL'en (specialtegn skal URL-kodes):

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

HTTP-headere

Angiv adressen via X-Address-*-headere – det er sådan, openHAB-integrationen gør det. Bemærk: ingen specialtegn i headere, skriv f.eks. "ue" i stedet for "ü".

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

JSON-body

Send adressen som et JSON-objekt i forespørgslens body:

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

Eksempel: curl-kald

Et komplet kald med en JSON-body ser sådan ud:

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

Det samme kald med en API-nøgle:

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

← Integrationsoversigt  ·  Fuld API-dokumentation