strava-cz-api 2.5.3

Rest API for strava.cz.

Strava.cz rest API

⚠️ UPOZORNĚNÍ: Strava.cz má vysoce proměnlivé prostředí (každá jídelna má jiný počet obědů, jiné názvy chodů apod.) z toho důvodu toto API není plně univerzální. I když jsem se snažil ho napsat univerzálně, nějaké metody nemusí plně fungovat a bude to vyžadovat vaší opravu.

Toto je neoficiální REST api pro stravu.cz. V tomto dokumentu je popsáno vše co potřebuješ vědet o tomto API. Je zde také vysvětleno dopodrobna jak to celé funguje.

Instalace

pip install strava_cz_api

Verze	Stav	Poznámka
1.X	❌	Stará verze bez error handlingu. Funkční :D
2.0 - 2.5	⚠️	Mnoho bugů v POST requestech a práci s cookies.
2.5.1 - 2.5.2	⚠️	Problém v importování modulů
2.5.3	✅

Autentizace

K API endpointům potřebuješ SID a s5url. Můžeš si je získat sám z dev tools v prohlížeči, ale nejlepší cesta je pomocí metod: Auth.login() a Auth.getCredentials():

from strava_cz_api import Auth

data, cookie = Auth.login("demo", "demo", "0000")
sid, s5url = Auth.getCredentials(data)

ℹ️ Podporované jazyky: CZ, EN, SK.

ℹ️ Auth.login() vrací cookie a JSON data; Auth.getCredentials() z nich vytáhne sid a s5url.

Inicializace API

from strava_cz_api import Api

api = Api(
    sid="00000000000000000000000000000000",
    s5url="", 
    cislo_jidelny="0000"
)

ℹ️ s5url může být hash, url či prázdné. Někdy se stane, že musí být spravný input, někdy může být prázné.

Veřejné endpointy (bez přihlášení)

Metoda	Popis	Poznámka
getJidelny()	Seznam jídelen
getJidelna()	Informace o jídělne
getS5url()	URL jídelny
getJidelnicek()	Get veřejného jídelníčku
getVersion()	Verze softwaru jídelny

Autentizované endpointy (Api)

Metoda	Popis	Poznámka
getJidelnicekToday()	Dnešní jídelníček	Vrací list (table0)
getJidelnicekAll()	Kompletní jídelníček
getInfo()	Informace o uživateli	Upravený payload.
getUsername()	Uživatelské jméno	Vytahuje z getInfo()
getJidelna()	Informace o jídelně
getHistorieKlienta(date)	Historie objednávek za měsíc	date = první den měsíce (např. 2025-01-01)
getPlatby()	Pohyby na účtu
getMessages()	Zprávy pro uživatele
getProtokol()	Vrátí protokol
getVydej()	Vrátí list vydaných jídel.
postJidlo(veta, stav)	Přihlásit/odhlásit jídlo	stav: 1 přihlásit, 0 odhlásit
postDen(datum, stav)	Přihlásit/odhlásit celý den	datum ve formátu YYYY-MM-DD
postOrders()	Uložit změny objednávek	Nutné po postJidlo/postDen
resetChanges()	Resetuje neuložené změny v komunikaci.	Dobré pro zrušení změn při objednávkách

ℹ️ Je poměrně jedno jestli používáme GET nebo POST, vždy to z nějakého důvodu funguje. Pro lepší logiku v kódu je to rozděleno.

Filtr

Filtr pro data existuje, ale bude se dále rozšiřovat. Lze ho importovat (from strava_cz_api import Filter), ale zatím není zaručeno, že všude funguje správně.

from strava_cz_api import Filter

filtrovano = Filter.filter_json(["veta"], api.getJidelnicekAll())
print(filtrovano)

Objednávky – správný postup

⚠️ Postup u každé jídelný se může lišit. Změny objednávek se ukládají ve dvou krocích:

1. Provedení změn (postJidlo nebo postDen)
2. Uložení (postOrders)

data, cookie = api.postJidlo(5, 1)

data, cookie = api.postOrders()

Nebo lze resetovat změny:

data, cookie = api.resetChanges()

Návratové hodnoty

• Většina metod vrací JSON string.
• POST metody postJidlo(), postDen(), postOrders(), resetChanges() a Auth.login() vrací dvojici (data, cookie) z POST odpovědi.
  • data - JSON response z API
  • cookie - nový cookie pro další požadavky (automaticky se aktualizuje v Api objektu)

⚠️ Je tedy potřeba buďto nepoužívat návratové hodnoty nebo jednu z nich vrátit do prázdné proměnné (např. _). Pokud vrátíte do jedné hodnoty vrátí se vám tupple a kód pravděpodobně někde spadne.

Chyby

• Error handling je dostupný přes výjimky, které lze importovat: from strava_cz_api import StravaError.
• Při neúspěšném požadavku se vyhazuje ConnectionError.

Příklady

Ukázkové skripty najdeš ve složce ./examples.

Json struktura

{
    "tableX": [
        {
            "id": 0,
            "datum": "30.06.2026", // datum
            "druh_popis": "Polévka", // část
            "druh_chod": "Oběd", // chod
            "nazev": "Polévka 1", // název chodu (oběd č. 1, Řízek)
            "popis": "Snídaně", // popis chodu
            "delsiPopis": "", // delší popis chodu
            "zakazaneAlergeny": null, // ??
            "alergeny_text": "", // alergeny
            "alergeny": [], // alergeny
            "chod": "C", // číslo chodu (A = snídaně, B, C)
            "druh": "OB", // druh chodu ve zkratce
            "cena": "45.00", // cena
            "polevka": "N", // zda pole je polévka (je v ceně)
            "pocet": 1, // 1 = přihlášeno, 0 = odhlášeno
            "veta": "172", // id políčka
            "vetaDieta": "196", // ??
            "omezeniObj": { // ???
                "den": "",
                "obj": "",
                "zm": "", 
                "bur": "C" 
            },
            "burza": { // ???
                "zmena": "0",
                "ostatni": "0",
                "nabidka": "0",
                "poptavka": "0"
            },
            "vydejniMisto": { // kde se vydává oběd (škola má více jídelních budov)
                "misto": "2",
                "mista": "2"
            },
            "diety": { // ??
                "dieta": "",
                "diety": ""
            },
            "zkratkaProduktu": "OB", // zkratka produktu (identické jako chod, u polévky chybí??)
            "cisloJidelnicku": "1", // ??
            "multipleNazev": "1NOběd č. 1COB", // ??
            "version": 5, // ??
            "casKonec": "2026-06-29T11:50:00", // do kdy lze přihlásit
            "casOdhlaseni": "2026-06-29T11:50:00", // do kdy lze přihlásit
            "obrazky": []
        },
        ...
    ]
}

• Mnoho polí není vyplněno. Zda víte co to je, doplňte to nebo mě kontaktujte.

Strava verze

• Zaznamenané strava verze společně s poznámkami. Seřazeno od nejpoužívanějších.

Verze	Poznámka
5.14
5.13	Vytvářeno. Testováno.
4.65
4.64
4.00
5.12
5.15
5.11
4.51	Demo verze. Testováno. Nějaké metody nefungují.

• Největší rozdíly jsou většinou mezi verzí 4 a 5. Endpointy a outputy jsou podobné.
• Pravděpodobně od verze 5 je vyžadováno s5url
• Mnoho polí není vyplněno. Pokud máte nějaké poznamky. Doplňte je nebo mě kontaktujte.

Demo

• Demo uživatele si lze vytvořit na https://www.strava.cz/strava/Stravnik/Demo
• Poté se lze přihlásit na https://app.strava.cz/ na jídelně 0000
• Prosím nepoužívejte demo demo. Pak je to zablokované a nefunguje to :D.