Preskočiť na obsah

Strava

Strava je primárna integrácia PeakLine. Jej pripojenie odomkne celú sadu funkcií: synchronizáciu aktivít, úplnú analýzu, sledovanie výbavy, úspechy, automatické reporty a Secret Club.

Pripojenie

  1. Otvorte thepeakline.com a kliknite na Connect with Strava, alebo otvorte Settings → Integrations → Strava → Connect, ak už máte e-mailový účet.
  2. Budete presmerovaní na štandardnú stránku OAuth2 od Stravy na strava.com.
  3. Strava zobrazí zoznam oprávnení (scopes), ktoré PeakLine požaduje (pozri nižšie). Kliknite na Authorize.
  4. Budete presmerovaní späť do PeakLine s nastaveným session cookie.
  5. PeakLine spustí úvodnú synchronizáciu vašich posledných 30 aktivít.

Celý proces trvá približne 30 sekúnd.

Požadované oprávnenia (scopes)

Scope Čo nám to umožňuje Prečo
read Čítať váš verejný profil a zóny Vykresliť nástenku, použiť vaše FTP, ak ste ho nastavili na Strave
activity:read_all Čítať všetky vaše aktivity vrátane súkromných Analyzovať ich, zostaviť vašu nástenku
profile:read_all Čítať polia profilu nad rámec verejných Bohatšie vykreslenie profilu (voliteľné)
activity:write Pridávať / aktualizovať popisy aktivít Iba ak povolíte automatické reporty

Nikdy nepožadujeme profile:write. Nemôžeme upravovať váš účet, sledovať iných používateľov vo vašom mene ani publikovať na Strave vo vašom mene.

Čo zostáva synchronizované

Po pripojení:

  • Nové aktivity sú zachytené prostredníctvom webhooku v priebehu niekoľkých sekúnd po nahratí.
  • Úpravy (premenovanie aktivity, zmena typu, skrytie z feedu) sa premietnu do PeakLine pri ďalšej webhook udalosti.
  • Vymazania sa kaskádovo prejavia v PeakLine — vymazané aktivity zmiznú z vašej nástenky.
  • Zmeny výbavy sa synchronizujú na požiadanie. Ak na Strave pridáte nový bicykel, objaví sa v zozname výbavy PeakLine pri jeho ďalšom otvorení.

Automatická aktualizácia popisov aktivít

Podľa nášho názoru najužitočnejšia integrácia so Stravou.

Povoľte ju v Settings → Strava → Auto-update descriptions a vyberte formát:

🌡️ 14°C • 💨 12 km/h SW • 🌅 sunrise 06:43 • PLS 762 (Very Good) • SP 84 (Hard) • ❤️ Z2 65% Z3 22%

PeakLine analysis:

🏆 PeakLine Score: 762 (Very Good)
📈 Stress Points: 84 (Hard)
🌡️ Temperature: 14°C (felt like 11°C)
💨 Wind: 12 km/h from SW (−7% impact)
💧 Humidity: 68%
🌅 Sunrise: 06:43, sunset: 21:14
🌫️ Air quality: Good (AQI 2)

Heart rate zones:
Z1 5%  Z2 65%  Z3 22%  Z4 7%  Z5 1%

Climbs: 3 (total 487 m)
Best VAM: 1,143 m/h on the long climb at km 22

Compared to last 10 rides: +1.2 km/h average speed

Pri prvom spustení na novej jazde uvidíte aktualizáciu popisu na Strave do približne 30 sekúnd po nahratí. Aktualizuje sa iba popis, ktorý napísal PeakLine — ak pridáte vlastný text, váš text zostane zachovaný nad blokom PeakLine.

Môžete ju kedykoľvek vypnúť, prípadne ju selektívne deaktivovať pre jednotlivé aktivity zo stránky danej aktivity.

Webhooky pod kapotou

PeakLine sa prihlási na odber webhooku Stravy pre vaše ID atléta. Keď sa spustí udalosť novej aktivity, Strava odošle metódou POST malý JSON payload do PeakLine a my na pozadí spustíme analytický pipeline.

Čo to v praxi znamená:

  • Žiadne dopytovanie (polling). PeakLine nezahlcuje API Stravy kontrolovaním nových aktivít.
  • Latencia pod jednu minútu. Väčšina aktivít je plne zanalyzovaná do 30 sekúnd od momentu, keď na Strave ťuknete na „uložiť“.
  • Odolnosť. Ak webhook Stravy zlyhá (výpadok ich služby), PeakLine doplní zameškané pri ďalšom otvorení nástenky.

Odpojenie

Buď:

Obe cesty okamžite zneplatnia token. PeakLine prestane synchronizovať.

Ak sa neskôr znova pripojíte, váš účet v PeakLine zostane zachovaný, no aktivity synchronizované pred opätovným pripojením môže byť potrebné obnoviť manuálne.

Limity počtu požiadaviek a prihlasovacie údaje

Strava vynucuje prísne limity na počet API požiadaviek (200 požiadaviek za 15 minút na aplikáciu, 2000 za deň). PeakLine rotuje medzi viacerými zaregistrovanými prihlasovacími údajmi aplikácie Strava, aby zostal pod limitom na jednu aplikáciu, s automatickým failoverom a 5-minútovým cooldownom pri chybných prihlasovacích údajoch.

Nevšimnete si to, pokiaľ naraz nespustíte masívne doplnenie (backfill) rokov historických aktivít. V takom prípade PeakLine zaradí prácu do fronty a spracuje ju v priebehu niekoľkých minút.

Pozri tiež