Saltar al contenido

Integración con API

Todos los datos de recogida están disponibles a través de una API HTTP abierta. La API es la base de cualquier integración: úsala directamente en tus propias aplicaciones, scripts o sistemas domóticos.

Endpoint

El endpoint central devuelve todas las fechas de recogida de una dirección, agrupadas por tipo de residuo, en formato JSON. Es el mismo endpoint que se usa en la integración con openHAB:

POSThttps://binable.app/api/fetch

Método: POST · Respuesta: JSON · La clave de API es opcional: las solicitudes anónimas son posibles, pero pueden estar sujetas a límites de frecuencia más estrictos.

Con una clave de API obtienes límites de frecuencia más altos. Solo tienes que añadir la cabecera Authorization: ApiKey <tu-clave>. Obtener clave de API gratuita

Enviar la dirección

La dirección se puede enviar de tres maneras distintas: elige la que mejor se adapte a tu sistema.

Se utilizan los siguientes campos: street, houseNumber, zip, city y country (código de país ISO 3166-1 alpha-2, p. ej. DE).

Parámetros de consulta

Añade los campos de la dirección a la URL (los caracteres especiales deben codificarse para la URL):

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

Cabeceras HTTP

Envía la dirección mediante cabeceras X-Address-*: así lo hace la integración con openHAB. Nota: sin caracteres especiales en las cabeceras, escribe por ejemplo "ue" en lugar de "ü".

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

Cuerpo JSON

Envía la dirección como objeto JSON en el cuerpo de la solicitud:

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

Ejemplo: llamada con curl

Una llamada completa con un cuerpo JSON tiene este aspecto:

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

La misma llamada con una clave de 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"}'

← Vista general de integraciones  ·  Documentación completa de la API