Quickstart

1. Załóż konto

Zarejestruj się na getsens.energy — formularz Early Access pozwala uruchomić darmowy trial. Po rejestracji dostajesz dostęp do panelu klienta (portal.getsens.energy), z poziomu którego wygenerujesz klucz API.

2. Wygeneruj klucz API

W panelu klienta: Integrations → API Keys → Generate Key. Klucz ma postać sens_live_... — traktuj go jak hasło, nie commituj go do repo. Więcej o zakresie i poziomach kluczy: Uwierzytelnianie.

3. Pierwsze zapytanie

Endpoint /api/v1/prices zwraca złożone ceny energii dla wybranego OSD (operatora dystrybucyjnego), sprzedawcy i taryfy:

curl -s "https://api.getsens.energy/api/v1/prices?osd=tauron&taryfa=G11&annual_kwh=2000" \
  -H "X-API-KEY: sens_live_your_key_here"

Przykładowa odpowiedź

Realna odpowiedź na powyższe zapytanie (nie dane ilustracyjne — tak to faktycznie wygląda), skrócona do najważniejszych pól:

{
  "meta": {
    "mode": "party_sheet",
    "resolved": { "osd": "TAURON Dystrybucja S.A.", "taryfa": "G11" },
    "last_updated_at": "2026-08-21T14:28:02.105112730Z"
  },
  "offers": [
    {
      "tariff_code": "G11",
      "zones": ["Calodobowy"],
      "summary": {
        "variable_total_pln_per_kwh": { "Calodobowy": 0.2795 },
        "fixed_total_pln_per_month": 22.8
      }
    }
  ],
  "warnings": []
}

Ucięte tu pola offers[].supply/distribution/global niosą pełne, zaudytowalne rozbicie na poszczególne składniki (nazwa, wartość, jednostka, okres obowiązywania taryfy źródłowej) — nie tylko zsumowaną stawkę. Pełny, wiążący schemat, w tym pola zależne od trybu zapytania (overview, pair, party_sheet, market_pair, market_only), zawsze znajdziesz w Swagger UI.

4. Co dalej

• Uwierzytelnianie i poziomy dostępu
• Przegląd endpointów API
• Zapytania różnicowe (since) — jeśli budujesz klienta odpytującego cyklicznie
• Integracja z agentami AI przez MCP