strava.cz-api 1.2__tar.gz → 2.1__tar.gz

strava_cz_api-2.1/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: strava.cz_api
+Version: 2.1
+Summary: Rest API for strava.cz.
+Author-email: Matěj Adamec <kralyk@kralyk.dev>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 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
+```bash
+pip install strava.cz_api
+```
+
+## 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()`:
+
+```py
+from strava import Auth
+
+cookie, data = Auth.login("demo", "demo", "0000")
+sid, s5url = Auth.getCredentials(data)
+```
+
+**Poznámky:**
+- Podporované jazyky: `CZ`, `EN`, `SK`.
+- `Auth.login()` vrací `cookie` a JSON data; `Auth.getCredentials()` z nich vytáhne `sid` a `s5url`.
+
+## Inicializace API
+```py
+from strava import Api
+
+api = Api(
+    sid="00000000000000000000000000000000",
+    s5url="", 
+    cislo_jidelny="0000"
+)
+```
+
+**Poznámky:**
+- `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 
+
+## 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
+| `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`) |
+| `getPlaby()` | 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` |
+
+## Objednávky – správný postup
+Změny objednávek se ukládají ve dvou krocích:
+1. Provedení změn (`postJidlo` nebo `postDen`)
+2. Uložení (`postOrders`)
+
+```py
+cookie_data = api.postJidlo(5, 1)
+cookie_data = api.postOrders()
+```
+
+## Návratové hodnoty
+Většina metod vrací JSON string. Metody `postJidlo`, `postDen` a `postOrders` vrací dvojici `(cookie, data)` z POST odpovědi. 
+
+## Chyby a omezení
+- Error handling je dostupný přes výjimky, které lze importovat: `from strava import StravaError`.
+- Při neúspěšném požadavku se vyhazuje `ConnectionError`.
+- Některé jídelny mohou vyžadovat úpravy payloadů nebo cookie.
+
+## Příklady
+Ukázkové skripty najdeš ve složce `./examples`.
+
+## 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`

strava_cz_api-2.1/README.md

@@ -0,0 +1,88 @@
+# 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
+```bash
+pip install strava.cz_api
+```
+
+## 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()`:
+
+```py
+from strava import Auth
+
+cookie, data = Auth.login("demo", "demo", "0000")
+sid, s5url = Auth.getCredentials(data)
+```
+
+**Poznámky:**
+- Podporované jazyky: `CZ`, `EN`, `SK`.
+- `Auth.login()` vrací `cookie` a JSON data; `Auth.getCredentials()` z nich vytáhne `sid` a `s5url`.
+
+## Inicializace API
+```py
+from strava import Api
+
+api = Api(
+    sid="00000000000000000000000000000000",
+    s5url="", 
+    cislo_jidelny="0000"
+)
+```
+
+**Poznámky:**
+- `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 
+
+## 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
+| `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`) |
+| `getPlaby()` | 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` |
+
+## Objednávky – správný postup
+Změny objednávek se ukládají ve dvou krocích:
+1. Provedení změn (`postJidlo` nebo `postDen`)
+2. Uložení (`postOrders`)
+
+```py
+cookie_data = api.postJidlo(5, 1)
+cookie_data = api.postOrders()
+```
+
+## Návratové hodnoty
+Většina metod vrací JSON string. Metody `postJidlo`, `postDen` a `postOrders` vrací dvojici `(cookie, data)` z POST odpovědi. 
+
+## Chyby a omezení
+- Error handling je dostupný přes výjimky, které lze importovat: `from strava import StravaError`.
+- Při neúspěšném požadavku se vyhazuje `ConnectionError`.
+- Některé jídelny mohou vyžadovat úpravy payloadů nebo cookie.
+
+## Příklady
+Ukázkové skripty najdeš ve složce `./examples`.
+
+## 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`

{strava_cz_api-1.2 → strava_cz_api-2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "strava.cz_api"
-version = "1.2"
+version = "2.1"
 description = "Rest API for strava.cz."
 readme = "README.md"
 requires-python = ">=3.8"

strava_cz_api-2.1/strava/action.py

@@ -0,0 +1,78 @@
+import requests
+import json
+
+class StravaError(Exception):
+    pass
+
+class JidelnaNenalezenaError(StravaError):
+    pass
+
+class ChybneHesloError(StravaError):
+    pass
+
+class BackendError(StravaError):
+    pass
+
+class ChybneSID(StravaError):
+    pass
+
+def raise_api_error(data):
+    if data.get("state") != "error":
+        return
+
+    number = data.get("number")
+    message = data.get("message", "Neznámá chyba")
+
+    exc = ERROR_MAP.get(number, StravaError)
+    raise exc(message)
+
+
+ERROR_MAP = {
+    6: JidelnaNenalezenaError,
+    15: ChybneSID,
+    13405: ChybneHesloError,
+    3002: BackendError,
+}
+
+class Get:
+    @staticmethod
+    def call(url, payload, headers=
+        {
+            "Content-Type": "text/plain;charset=UTF-8",
+            "Cookie": "NEXT_LOCALE=cs; multiContextSession=%7B%22printOpen%22%3A%7B%22value%22%3Afalse%2C%22expiration%22%3A-1%7D%7D",
+            "Referer": "https://app.strava.cz/"
+        }):
+
+        response = requests.post(url, headers=headers, json=payload)
+            
+        data = response.json()
+
+        raise_api_error(data)
+
+        return json.dumps(data, indent=2, ensure_ascii=False)
+            
+
+
+class Post:
+    @staticmethod
+    def call(url, payload, cookie, headers=None):
+        if headers is None:
+            headers = {
+                "Content-Type": "text/plain;charset=UTF-8",
+                "Cookie": cookie,
+                "Referer": "https://app.strava.cz/"
+            }
+
+
+        response = requests.post(url, headers=headers, json=payload)
+
+        data = response.json()
+
+        raise_api_error(data)
+
+        new_cookie = "; ".join([f"{k}={v}" for k, v in response.cookies.items()])
+
+        return new_cookie, data
+
+
+

strava_cz_api-2.1/strava/strava.py

@@ -0,0 +1,362 @@
+import requests
+import json
+from action import Get, Post
+
+from action import (
+    StravaError,
+    JidelnaNenalezenaError,
+    ChybneHesloError,
+    BackendError,
+    ChybneSID
+)
+
+__all__ = [
+    "Api",
+    "Auth",
+    "StravaError",
+    "JidelnaNenalezenaError",
+    "ChybneHesloError",
+    "BackendError",
+    "ChybneSID"
+]
+
+
+class Api:
+    def __init__(self, sid, s5url, cislo_jidelny, cookie="NEXT_LOCALE=cs; multiContextSession=%7B%22printOpen%22%3A%7B%22value%22%3Afalse%2C%22expiration%22%3A-1%7D%7D", lang="CZ"):
+        if lang not in ("CZ", "EN", "SK"):
+            raise ValueError("Podporované jazyky: EN, CZ, SK")
+        
+        self.sid = sid
+        self.lang = lang
+        self.cislo_jidelny = cislo_jidelny
+        self.cookie = cookie
+        self.s5url = s5url
+
+        self.base = "https://app.strava.cz/api"
+
+
+    def getJidelnicekToday(self):
+        """
+        Vrátí dnešní jídelníček
+        """
+        return json.loads(self.getJidelnicekAll()).get("table0", [])
+
+
+    def getJidelnicekAll(self):
+        """
+        Vrátí celý jídelníček
+        """
+        url = f"{self.base}/objednavky"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "s5url": self.s5url,
+            "lang": self.lang,
+            "konto": 0,
+            "podminka": "",
+            "ignoreCert": "false"
+        }
+
+        return Get.call(url, payload)
+
+
+    def getInfo(self):
+        """
+        Vrátí info o uživateli
+        """
+        url = f"{self.base}/nactiVlastnostiPA"
+
+        payload = {
+            "sid": self.sid,
+            "url": self.s5url,
+            "cislo": self.cislo_jidelny,
+            "ignoreCert": "false",
+            "lang": self.lang,
+            "getText": True,
+            "checkVersion": True,
+            "resetTables" :True,
+            "frontendFunction": "refreshInformations"
+        }
+
+
+        return Get.call(url, payload)
+    
+
+    def getUsername(self):
+        """
+        Vrátí uživatelské jméno
+        """
+
+        return json.loads(self.getInfo()).get("id")
+
+
+    def getJidelna(self):
+        """
+        Získá informaci o jídělně
+        """
+
+        url = f"{self.base}/jidelnaS5"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "url": self.s5url,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def getHistorieKlienta(self, date):
+        """
+        Získá info o historii objednávek.
+        
+        date = počáteční datum měsíce. 
+        2025-01-01 - leden
+        2025-12-01 - prosinec
+        """
+
+        url = f"{self.base}/historieKlienta"
+
+        payload = {
+            "sid": self.sid,
+            "url": self.s5url,
+            "cislo": self.cislo_jidelny,
+            "datum": date,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def getPlaby(self):
+        """
+        Vrátí platby na účtu.
+        """
+
+        url = f"{self.base}/platby"
+
+        payload = {
+            "sid": self.sid,
+            "url": self.s5url,
+            "cislo": self.cislo_jidelny,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def getMessages(self):
+        """
+        Vratí zprávy poslané uživatelovi.
+        """
+
+        url = f"{self.base}/messagesGetList"
+
+        payload = {
+            "sid": "",
+            "idO":"",
+            "idJ": self.cislo_jidelny,
+            "idU": self.getUsername(),
+            "typZpravy": ""
+        }
+
+        return Get.call(url, payload)
+
+
+    def getProtokol(self):
+        """
+        Vrátí protokol.
+        """
+
+        url = f"{self.base}/getProtokol"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "s5url": self.s5url,
+            "sid": self.sid,
+            "ignoreCert": "false",
+            "lang": self.lang,
+            "uroven": "KP",
+            "evCislo": 0
+        }
+
+
+        return Get.call(url, payload)
+
+    def getVydej(self):
+        """
+        Vrátí list vydaných jídel.
+        """
+
+        url = f"{self.base}/vydej"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "s5url": self.s5url,
+            "sid": self.sid,
+            "ignoreCert": "false",
+            "lang": self.lang,
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def postJidlo(self, veta, stav):
+        """
+        Příhlásí nebo odhlásí jídlo.
+        
+        veta = číslo políčka/jídla - jde získat např. z getJidelnicek()
+        stav =  0 odhlásit - 1 přihlásit
+        """
+        url = f"{self.base}/pridejJidloS5"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "url": self.s5url,
+            "veta": veta, 
+            "pocet": stav, # 0 ohlasit - 1 prihlasit
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+        self.cookie = Post.call(url, payload, self.cookie)
+
+        return self.cookie
+
+
+    def postOrders(self):
+        """
+        Uloží objednávky
+        """
+        url = f"{self.base}/saveOrders"
+
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "url": self.s5url,
+            "xml": None,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+        
+        self.cookie = Post.call(url, payload, self.cookie)
+
+        return self.cookie
+
+
+    def postDen(self, datum, stav):
+        """
+        Přihlásí nebo ohlásí celý den.
+        
+        datum = datum dne jaký chceme odhlásit. 2025-12-30
+        stav =  0 ohlasit - 1 prihlasit
+        """
+
+        url = f"{self.base}/objednejDenS5"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "url": self.s5url,
+            "datum": datum,
+            "pocet": stav,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+        self.cookie = Post.call(url, payload, self.cookie)
+
+        return self.cookie
+
+
+class Public:
+    def getJidelnicek(cislo_jidelny, lang):
+        """
+        Získání public jídelníčků.
+        """
+        if lang not in ("CZ", "EN", "SK"):
+            raise ValueError("Podporované jazyky: EN, CZ, SK")
+
+        url = "https://app.strava.cz/api/jidelnicky"
+
+        payload = {
+            "cislo": cislo_jidelny,
+            "s5url": Public.getS5url(cislo_jidelny),
+            "lang": lang,
+            "ignoreCert": False
+        }
+
+        return Get.call(url, payload)
+
+    def getJidelna(cislo_jidelny):
+        """
+        Vrátí informaci o jídelně.
+        """
+        url = "https://app.strava.cz/api/s4Polozky"
+
+        payload = {
+            "cislo": cislo_jidelny,
+            "lang": "CZ",
+            "polozky": "V_NAZEV,V_ULICE,V_MESTO,V_PSC,V_TELEFON,V_UCET,V_EMAIL,V_URL,DATCAS_AKT,VERZE,URLWSDL_S-URL,GPSDELKA,GPSSIRKA,IGN_CERT,TEXT_ANON,LOGO"}
+
+        return Get.call(url, payload)
+
+    def getS5url(cislo_jidelny):
+        """
+        Pomocná metoda co vratí url jídelny.
+        """
+        return json.loads(Public.getJidelna(cislo_jidelny)).get("urlwsdl_s")[0]
+        
+
+    def getJidelny():
+        """
+        Vrátí seznam všech jídelen a jejich čísel.
+        """
+        url = "https://app.strava.cz/api/zarAMesta"
+        
+        payload = {
+            "lang":"CZ"
+        }
+
+        return Get.call(url, payload)
+
+
+class Auth:
+    def login(username, password, cislo_jidelny, lang="CZ", zustat_prihlasen=True, cookie="NEXT_LOCALE=cs"):
+        """
+        Vrátí data nutná pro další komunikaci.
+        """
+        if lang not in ("CZ", "EN", "SK"):
+            raise ValueError("Podporované jazyky: EN, CZ, SK")
+        
+        url = "https://app.strava.cz/api/login"
+
+        payload = {
+            "cislo": cislo_jidelny,
+            "jmeno": username,
+            "heslo": password,
+            "zustatPrihlasen": zustat_prihlasen,
+            "environment": "W",
+            "lang": lang
+        }
+
+        return Post.call(url, payload, cookie)
+
+    def getCredentials(data):
+        """
+        Vyfiltruje SID a s5url z funkce login
+        """
+
+        sid = data.get("sid")
+        s5url = data.get("s5url")
+        return sid, s5url