Перейти до змісту

Strava

Strava — це основна інтеграція PeakLine. Її підключення відкриває повний набір функцій: синхронізацію активностей, повний аналіз, відстеження спорядження, досягнення, автозвіти та Secret Club.

Підключення

  1. Відкрийте thepeakline.com і натисніть Connect with Strava або відкрийте Settings → Integrations → Strava → Connect, якщо у вас уже є обліковий запис Email.
  2. Вас буде перенаправлено на стандартну сторінку OAuth2 від Strava на strava.com.
  3. Strava перелічує дозволи (scopes), які запитує PeakLine (див. нижче). Натисніть Authorize.
  4. Вас буде повернено назад до PeakLine із встановленим cookie сесії.
  5. PeakLine запускає початкову синхронізацію ваших останніх 30 активностей.

Увесь процес займає близько 30 секунд.

Запитувані дозволи (scopes)

Scope Що це дозволяє нам робити Навіщо
read Читати ваш публічний профіль і зони Відрендерити панель управління, використати ваш FTP, якщо ви вказали його у Strava
activity:read_all Читати всі ваші активності, включно з приватними Аналізувати їх, будувати вашу панель управління
profile:read_all Читати поля профілю поза публічними Багатше відображення профілю (необов'язково)
activity:write Додавати до / оновлювати описи активностей Тільки якщо ви ввімкнете автозвіти

Ми ніколи не запитуємо profile:write. Ми не можемо змінювати ваш обліковий запис, підписуватися на інших користувачів від вашого імені чи публікувати у Strava замість вас.

Що залишається синхронізованим

Після підключення:

  • Нові активності підхоплюються вебхуком протягом кількох секунд після завантаження.
  • Редагування (перейменування активності, зміна типу, приховування зі стрічки) поширюються на PeakLine під час наступної події вебхука.
  • Видалення каскадно передаються до PeakLine — видалені активності зникають із вашої панелі управління.
  • Зміни спорядження синхронізуються за запитом. Якщо ви додаєте новий велосипед у Strava, він з'являється у списку спорядження PeakLine під час наступного відкриття.

Автооновлення описів активностей

На нашу думку, найкорисніша інтеграція зі Strava.

Увімкніть її в Settings → Strava → Auto-update descriptions, оберіть формат:

🌡️ 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

Коли воно вперше спрацьовує на новій поїздці, ви побачите оновлення опису у Strava протягом ~30 секунд після завантаження. Воно оновлює лише той опис, який написав PeakLine — якщо ви додаєте власний текст, ваш текст зберігається над блоком PeakLine.

Ви можете вимкнути це будь-коли або вибірково вимкнути для окремої активності на сторінці активності.

Вебхуки під капотом

PeakLine підписується на вебхук Strava для вашого ID атлета. Коли спрацьовує подія нової активності, Strava надсилає невеликий JSON-пейлоад методом POST до PeakLine, і ми запускаємо конвеєр аналізу у фоновому режимі.

Що це означає на практиці:

  • Без опитування (polling). PeakLine не навантажує API Strava перевірками на нові активності.
  • Затримка менше хвилини. Більшість активностей повністю аналізуються протягом 30 секунд після того, як ви натиснули «save» у Strava.
  • Стійкість до збоїв. Якщо вебхук Strava дає збій (їхній сервіс заїкається), PeakLine надолужує наступного разу, коли ви відкриваєте панель управління.

Відключення

Будь-яким способом:

  • Із PeakLine: Settings → Strava → Disconnect.
  • Зі Strava: strava.com/settings/apps → PeakLine → Revoke Access.

Будь-який із цих шляхів негайно робить токен недійсним. PeakLine припиняє синхронізацію.

Якщо ви підключитеся знову пізніше, ваш обліковий запис у PeakLine зберігається, але активності, синхронізовані до повторного підключення, можливо, доведеться оновити вручну.

Ліміти запитів і креденшіали

Strava застосовує суворі ліміти запитів до API (200 запитів за 15 хвилин на застосунок, 2000 на день). PeakLine чергує кілька зареєстрованих креденшіалів застосунків Strava, щоб залишатися в межах ліміту на застосунок, з автоматичним перемиканням при збої (failover) та 5-хвилинним кулдауном на креденшіалах, що дали помилку.

Ви цього не помітите, якщо тільки не запустите масштабне завантаження (backfill) історичних активностей за роки одразу. У такому разі PeakLine ставить роботу в чергу й обробляє її протягом кількох хвилин.

Дивіться також