본문으로 건너뛰기
버전: 개발 버전 (최신)

모바일 API 개요

개요​

DTA-Wide 모바일 API는 모바일 앱의 초기화 및 설정 관리를 위한 API를 제공합니다. 모바일 앱이 시작될 때 필요한 시스템 설정, 다국어 지원, 기능 활성화 상태 등의 정보를 조회할 수 있습니다.

모바일 API 목록​

모바일 관련 API는 다음과 같습니다:

앱 설정 API​

모바일 앱 초기화 시 필요한 통합 시스템 설정 정보를 제공합니다.

API 엔드포인트메서드설명
/v1/mobile/app-settingsGET앱 설정 정보 조회

앱 설정 API 상세 보기

주요 기능​

시스템 설정 관리​

  • 앱 버전 호환성: 현재 앱 버전과 최소 지원 버전 정보 제공
  • 점검 모드: 서버 점검 상태 확인
  • 기능 토글: 설문지, 수면 추적, 알림 등 기능별 활성화 상태 관리

다국어 지원​

  • 언어 설정: 사용자 언어 설정에 따른 적절한 로케일 정보 제공
  • 지역화: 날짜/시간 형식, 지원 언어 목록 등 지역별 설정
  • Accept-Language 헤더: 요청 시 언어 태그를 통한 동적 언어 설정

보안 및 성능 설정​

  • 토큰 관리: 토큰 갱신 간격 및 보안 정책 설정
  • API 설정: 엔드포인트 URL, 타임아웃, 재시도 정책
  • 속도 제한: 분당 요청 제한 등 API 사용량 관리

인증 요구사항​

모든 모바일 API는 앱 토큰 인증이 필요합니다:

  • Authorization 헤더: Bearer <app-token> 형식으로 앱 토큰 전달
  • 앱 토큰 획득: 앱 인증 API를 통해 사전에 앱 토큰을 발급받아야 함

사용 흐름​

일반적인 모바일 API 사용 흐름은 다음과 같습니다:

  1. 앱 인증을 통해 appToken 획득
  2. appToken을 사용하여 앱 설정 정보 조회
  3. 조회된 설정 정보를 바탕으로 모바일 앱 초기화
  4. 기능 활성화 상태에 따라 앱 UI/UX 구성
  5. 언어 설정에 따라 적절한 다국어 리소스 적용

변경 이력​

버전날짜작성자변경 내용
0.1.02025-05-27elizabeth@weltcorp.com최초 작성 - 모바일 API 개요 문서화