WELT Insomnia API 문서
소개
WELT Insomnia API 문서에 오신 것을 환영합니다.
이 문서는 독일 시장용 dta-wide-api, 한국 시장용 dta-wikr-api, 디지털 헬스 애플리케이션용 dha-sleep-api 등 백엔드 서비스와 모바일 애플리케이션 간의 통합을 위한 포괄적인 가이드를 제공합니다. 특히 dha-sleep-api는 규제 대상 DTx가 아닌 DHA(Digital Health Application)임을 유념해 주세요.
문서 구성
이 문서는 다음과 같이 구성되어 있습니다:
1. 독일 API 가이드라인 (dta-wide-api)
백엔드 API를 사용하기 위한 공통 규약과 모범 사례를 설명합니다. 대상 서비스는 dta-wide-api입니다.
- API 개요: API 기본 정보 및 구조
- API 규약: URL 구조, HTTP 메서드, 응답 형식 등
- 인증 방법: 토큰 기반 인증 및 관리
- 에러 처리: API 에러 코드 및 처리 방법
2. 독일 API 레퍼런스 (dta-wide-api)
백엔드 API의 상세 명세와 사용 예시를 제공합니다.
- API 레퍼런스 개요: API 레퍼런스 사용 방법
- 도메인별 API: 각 도메인별 API 엔드포인트, 요청/응답 형식, 사용 예시
3. 한국 API 가이드라인 (dta-wikr-api)
한국 시장용 서비스는 dta-wikr-api를 사용합니다. 가이드라인 문서에서 한국 환경에 맞춘 인증, 규약, 오류 정책을 확인할 수 있습니다.
4. 한국 API 레퍼런스 (dta-wikr-api)
dta-wikr-api 엔드포인트별 요청/응답 형식과 예시를 제공합니다.
5. DHA Sleep API (digital health application)
- 서비스 이름:
dha-sleep-api - 분류: DTx가 아닌 digital health application
- 추가 가이드 및 레퍼런스는 본 섹션을 통해 순차 업데이트됩니다.
시작하기
모바일 개발자라면 다음 순서로 문서를 읽는 것을 권장합니다:
-
API 개요: API의 기본 구조와 사용 방법을 이해합니다.
-
API 규약: API 호출 시 준수해야 할 규약을 확인합니다.
-
인증 방법: API 인증 방법을 학습합니다.
-
관심 있는 도메인의 API 레퍼런스를 참조하여 구체적인 API 사용법을 익힙니다.
지원 및 문의
문서 내용에 대한 문의나 기술 지원이 필요한 경우 다음 채널을 이용해 주세요:
- 개발자 포럼: developer.example.com/forum
- 이메일: api-support@example.com
- 이슈 트래커: github.com/weltcorp/dta-wide-mono/issues
변경 이력
| 버전 | 날짜 | 주요 변경 사항 |
|---|---|---|
| 0.54.0 | 2025-11-26 | 서비스명 정정 및 DHA Sleep API(비-DTx) 안내 추가 |
| 0.53.3 | 2025-10-17 | de/KO 카테고리 추가 |
| 0.1.0 | 2025-04-01 | 초기 문서 릴리스 |