> ## Documentation Index
> Fetch the complete documentation index at: https://docs.habitify.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Strava

이미 Strava에서 달리기, 라이딩, 수영과 기타 운동을 기록하고 있다면 Habitify에 다시 기록할 필요가 없습니다. 이 연동 기능은 두 앱을 연결하여 Strava에서 활동을 완료하고 저장할 때마다 진행 상황이 일치하는 습관에 자동으로 동기화되도록 합니다.

땀은 사용자가 흘리고, 추적은 Habitify가 맡습니다. 이 문서에서 설정 방법을 안내합니다.

## Strava와 동기화되는 습관 추가하기

> [tab]   iOS
>
> [https://drive.google.com/file/d/1sNejJY7gvcyJK5zoTmcPWz4NVg3ql5uN/preview](https://drive.google.com/file/d/1sNejJY7gvcyJK5zoTmcPWz4NVg3ql5uN/preview)
>
> 1. **저널**에서 오른쪽 아래 모서리의 \*\*+\*\*를 탭한 다음 **좋은 습관 만들기**를 선택합니다.
> 2. 다음 화면에서 **Strava** 탭으로 전환합니다.
> 3. 목록에서 추적할 데이터 유형(예: "걸음 수")을 선택합니다.
> 4. 다음 단계에서 Strava 사이트로 이동합니다. Strava 계정에 로그인하고 Habitify에 접근 권한을 부여합니다.
> 5. 권한이 부여되면 Habitify로 돌아옵니다.
> 6. 평소처럼 습관의 세부 정보를 설정합니다.
> 7. 모든 설정을 마치면 \*\*✓\*\*를 탭하여 새로 만든 습관을 목록에 저장합니다.
>
> 습관을 만들고 나면 Strava에 연결된 습관을 쉽게 알아볼 수 있습니다. 저널 보기에 작은 Strava 아이콘이 표시되므로 직접 추적하는 습관과 한눈에 구분됩니다.

> [tab] 🤖 Android
>
> [https://drive.google.com/file/d/1p9Lj5qlRltVMMaBTlp0dKhlaHDh6l5lY/preview](https://drive.google.com/file/d/1p9Lj5qlRltVMMaBTlp0dKhlaHDh6l5lY/preview)
>
> 1. \_일지\_에서 화면 오른쪽 아래 날짜 표시줄의 **+ 버튼**을 탭합니다.
> 2. **새로운 습관 생성**을 선택합니다.
> 3. 습관 템플릿 화면 상단의 탭 중에서 **Strava**를 탭합니다.
> 4. Habitify가 Strava에서 가져올 수 있는 모든 활동 및 데이터 유형 목록에서 원하는 데이터 옵션 하나를 탭하여 선택합니다.
> 5. **목표**(예: 걸음 수 10,000보 또는 수면 8시간)를 설정한 다음 **접근 허용**을 탭합니다.
> 6. 다음 단계에서 Strava 사이트로 이동합니다. Strava 계정에 로그인하고 Habitify에 접근 권한을 부여합니다.
> 7. 권한이 부여되면 Habitify로 돌아와 **게속** 버튼을 탭합니다.
> 8. 평소처럼 습관을 설정합니다.
> 9. 모든 설정을 마치면 오른쪽 위 모서리의 **저장** 버튼을 탭합니다.
>
> 습관을 만들고 나면 Strava에 연결된 습관을 쉽게 알아볼 수 있습니다. 일지의 일 보기에서 작은 Strava 아이콘이 표시되므로 직접 추적하는 습관과 한눈에 구분됩니다.

> [tab] 🖥️ 웹사이트 및 데스크톱
>
> [https://drive.google.com/file/d/1YNh34ejdRnf2KvDWnN0mfkfTv1PI4CS8/preview](https://drive.google.com/file/d/1YNh34ejdRnf2KvDWnN0mfkfTv1PI4CS8/preview)
>
> 1. 왼쪽 탐색 표시줄에서 **모든 습관** 탭을 엽니다.
> 2. 하단 작업 표시줄로 이동하여 **+ 습관 추가**를 클릭한 다음 **좋은 습관 만들기**를 선택합니다.
> 3. 표시되는 창의 상단에서 **Strava** 탭을 선택합니다.
> 4. 지원되는 카테고리 목록에서 추적할 활동 유형(예: **달리기, 라이딩, 걷기,** 또는 **수영**)을 선택합니다.
> 5. Strava와 동기화되는 습관을 처음 만들 때는 Habitify에 Strava 데이터 접근 권한을 부여해야 합니다. \
>    습관 이름 아래에서 **접근 허용**을 클릭하고 다음 필수 단계를 따릅니다.
> 6. 연결에 성공하면 **접근 허용** 버튼이 사라집니다.\
>    이제 평소처럼 습관을 설정할 수 있습니다.
> 7. 마지막으로 오른쪽 아래 모서리의 **저장** 버튼을 클릭하여 새 습관을 추적 목록에 저장합니다.

## **연동 작동 방식**

습관이 생성되고 Strava에 연결되면 추적 과정이 자동으로 진행됩니다.

* Strava에서 새 활동을 기록하면 데이터가 Habitify로 전송됩니다.
* Habitify는 활동의 유형과 값(거리, 시간, 칼로리)이 습관 목표에 정의한 규칙을 충족하는지 확인합니다.
* 그런 다음 앱이 목표에서 요구하는 유형을 충족하는 데이터를 가져와 진행 상황으로 기록합니다.

목표값을 달성하면 습관이 자동으로 완료로 표시됩니다. Habitify에 직접 입력할 필요가 없습니다.

예시는 다음과 같습니다.

* **거리 기반 목표:**
  * **이름:** 매주 50km 사이클링
  * **목표:** 주당 50킬로미터
  * **Strava 연결:** 활동 유형: `라이딩`, 추적 기준: `거리`
* **시간 기반 목표:**
  * **이름:** 일주일에 3시간 운동하기
  * **목표:** 주당 3시간
  * **Strava 연결:** 활동 유형: `운동`, 추적 기준: `기간`

## **제한 사항**

* **한 번에 하나의 Strava 계정만 하나의 Habitify 계정에 연결할 수 있습니다.** Strava 계정을 새 Habitify 계정에 연결하면 이전 계정과의 연결이 자동으로 해제되고 기존 계정에 알림이 전송됩니다.
* **Strava는 데이터 동기화에 15분 단위의 순환 요청 한도를 적용합니다**(15분마다 전체 요청 최대 3,300회). 오류가 발생하거나 즉시 연동할 수 없다면 10\~15분 기다린 후 다시 시도하세요. 이는 일반적으로 추적 요청이 갑자기 늘어나 일시적으로 15분 한도에 도달했다는 뜻이며, 잠시 후 한도가 초기화됩니다.
* 습관을 Strava에 처음 연결하면 과거 활동을 가져와 진행 상황을 채웁니다. **Habitify는 관련 Strava 기록 중 최근 90일치까지만 동기화**하며, 습관 시작일이 더 최근이면 시작일 이후의 기록만 동기화합니다.
* **Strava → Habitify 단방향으로만 동기화됩니다.** 이 연동 기능은 Strava에서 완료한 활동을 가져와 Habitify에 기록하도록 설계되었습니다. Habitify 데이터가 Strava 계정으로 전송되거나 Strava 계정을 변경하는 일은 없습니다.
* **Strava에 연결된 습관에는 진행 기록을 직접 추가하거나 완료로 표시할 수 없습니다.** 습관을 Strava에 연결하면 진행 상황은 전적으로 Strava 활동으로 제어됩니다. 덕분에 언제나 정확한 데이터를 손쉽게 유지할 수 있습니다.

## 지원되는 데이터 유형 및 단위

현재 Habitify는 Strava의 50가지가 넘는 활동 유형 동기화를 지원합니다. 원하는 활동을 쉽게 찾을 수 있도록 아래와 같이 카테고리별로 분류했습니다.

1. **달리기 및 걷기**: 걸음 수와 이동 경로를 추적합니다. 지원 활동: 달리기, 걷기, 하이킹, 트레일 러닝, 가상 달리기.
2. **사이클링**: 도로, 산악 또는 실내 라이딩을 추적합니다. 지원 활동: 라이딩, 전기 자전거 타기, 전기 산악자전거 타기, 그래블 라이딩, 산악자전거 타기, 벨로모빌, 가상 자전거 타기, 핸드사이클.
3. **수상 스포츠**: 물 위에서 보낸 시간이나 이동 거리를 계산합니다. 지원 활동: 수영, 조정, 가상 조정, 카누, 카약, 스탠드업 패들링, 서핑, 윈드서핑, 카이트서핑, 세일링.
4. **겨울 스포츠**: 눈과 얼음 위에서 한 활동을 기록합니다. 지원 활동: 알파인 스키, 백컨트리 스키, 노르딕 스키, 롤러 스키, 스노보드, 스노슈잉, 아이스 스케이팅.
5. **헬스장 및 피트니스**: 실내 운동과 근력 운동을 모니터링합니다. 지원 활동: 운동, 웨이트 트레이닝, 크로스핏, 일립티컬, 스텝퍼, 요가, 필라테스.
6. **팀 및 라켓 스포츠**: 경기와 연습 세션을 기록합니다. 지원 활동: 축구, 테니스, 배드민턴, 피클볼, 스쿼시, 라켓볼, 골프.
7. **모험 및 기타**: 몸을 움직이게 하는 그 밖의 모든 활동입니다. 지원 활동: 암벽 등반, 스케이트보드, 인라인스케이트, 휠체어.

Strava 습관을 설정할 때는 Strava에서 기록하는 데이터에 해당하는 단위를 선택해야 합니다. 일반적으로 다음 항목을 추적할 수 있습니다.

* **거리:** (km, 마일, 미터, 야드) – 달리기, 사이클링, 수영 등 거리 기반 활동에서 사용할 수 있습니다.
* **기간:** (분, 시간) – 거의 모든 활동 유형에서 사용할 수 있습니다.
* **칼로리:** (kcal) – Strava 활동에 칼로리 데이터가 포함된 경우 사용할 수 있습니다.

## 자주 묻는 질문

> [accordion] **잘못된 Strava 계정에 연결했습니다. 어떻게 해야 하나요?**
>
> Strava 또는 브라우저에 활성 승인 정보가 캐시되어 있을 수 있습니다. 이 경우 “Strava와 연결”을 탭하면 이전 프로필이 별도 안내 없이 다시 승인됩니다.
>
> 잘못된 Strava 계정에서 Habitify의 승인을 취소하는 것이 좋습니다.
>
> 1. [strava.com/settings/apps](https://www.strava.com/settings/apps)로 이동합니다.
> 2. “Habitify”가 표시되면 접근 권한 취소를 클릭합니다(여러 Habitify 항목이 있다면 모두 취소).
>
> 잘못된 계정이 계속 확인 없이 다시 승인된다면 문의해 주세요. 저희 쪽에서 Habitify 계정에 저장된 Strava 승인 정보를 삭제해 드릴 수 있습니다. 초기화가 완료되었다는 확인을 받은 뒤 다시 연결을 시도하면 Strava 로그인/승인 페이지가 표시됩니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.