wangdrew/olyns-proxy repository overview

⁠Olyns API Proxy

A lightweight Flask‑based HTTP proxy that lets embedded devices (e.g., ESP32) call the Olyns API over plain HTTP. The proxy runs on a trusted local network and simply forwards requests to the official Olyns API, stripping away the HTTPS overhead and returning a reduced set of useful data: bin name, status and recycling levels.

⁠Key Features

Exposes a single GET REST endpoint

GET /<collector_id>

where <collector_id> is an integer ID of an Olyns collector.

Returns a reduced JSON payload:

{
  "name":      "Collector 170",
  "status":    "open",
  "aluminum":  75,
  "plastic":   45,
  "glass":     30
}

Intended for deployment on a trusted local network; no HTTPS needed.

⁠Quick start

docker run -d \
  --name olyns-proxy \
  -p 8200:8200 \
  wangdrew/olyns-proxy:latest

After the container starts, hit e.g.:

http://localhost:8200/170

and you’ll receive the simplified JSON for collector 170.