kaucja24.pl
REST API v1.0

API dla Firm i Gmin

Zintegruj bazę punktów zbiórki kaucji bezpośrednio w swojej aplikacji lub systemie sklepowym. Aktualizuj statusy automatów w czasie rzeczywistym.

Darmowe dla sklepów
Klucze API
JSON REST
Bez limitu odczytów

Autentykacja

Przekaż klucz API w nagłówku HTTP każdego żądania:

GET /api/v1/punkty?lat=52.23&lng=21.01&radius_km=3
X-Api-Key: twoj_klucz_api_tutaj

Klucz możesz też przekazać jako parametr URL: ?api_key=...

Uzyskaj klucz API: Napisz na api@kaucja24.pl z nazwą firmy i opisem zastosowania. Klucze są bezpłatne dla sklepów i gmin.

Endpointy

GET/api/v1/punktyread:points

Lista punktów zbiórki z opcjonalnym filtrowaniem po lokalizacji, typie i statusie.

ParametrTypOpis
latfloatSzerokość geograficzna
lngfloatDługość geograficzna
radius_kmfloatPromień wyszukiwania (domyślnie: 5)
typeenumAUTOMAT | SKLEP | CENTRUM_ZBIORKI
statusenumAKTYWNY | PELNY | NIECZYNNY
limitintMaks. wyników (domyślnie: 100, max: 500)
POST/api/v1/punkty/{id}/statuswrite:status

Aktualizacja statusu punktu (automat pełny, nieczynny, aktywny). Wymaga uprawnień write:status.

ParametrTypOpis
statusenumAKTYWNY | PELNY | NIECZYNNY
commentstringOpcjonalny komentarz

Przykładowa odpowiedź

{
  "data": [
    {
      "id": 42,
      "name": "Automat kaucja Lidl",
      "type": "AUTOMAT",
      "status": "AKTYWNY",
      "address": "ul. Marszałkowska 12",
      "postal_code": "00-001",
      "lat": 52.2297,
      "lng": 21.0122,
      "accepts_glass": true,
      "accepts_plastic": true,
      "accepts_cans": false,
      "opening_hours": "Pn-Nd 7:00-22:00",
      "chain_name": "Lidl",
      "avg_rating": 4.2,
      "rating_count": 18,
      "updated_at": "2026-04-18T00:00:00.000Z",
      "city": {
        "name": "Warszawa",
        "name_slug": "warszawa"
      }
    }
  ],
  "count": 1,
  "api_version": "1.0"
}

Limity i warunki użytkowania

  • Odczyt punktów — bez limitu zapytań
  • Aktualizacja statusu — do 1000 zapytań/dobę
  • Format odpowiedzi — JSON, UTF-8
  • SLA — 99.5% uptime, odpowiedź <200ms