API 레퍼런스 개요
ECARUS API 레퍼런스에 오신 것을 환영합니다. 이 섹션에서는 사용 가능한 모든 API 서비스에 대한 자세한 문서를 제공합니다.
OEM 비즈니스 가치
🚗 차량 차별화 전략
- 안전 브랜드 이미지: 가족 친화적 브랜드 포지셔닝 강화
- 프리미엄 서비스: 경쟁 모델과 차별화되는 첨단 기능 제공
- 고객 충성도: 강력한 구매 동기 부여 및 고객 유지
💰 새로운 수익 모델
- 구독 서비스: 월간/연간 프리미엄 서비스 구독 모델
- 데이터 분석: 운행 패턴 기반 개인화 부가 서비스
- 파트너십: B2B 서비스 확장 및 생태계 구축
📱 고객 경험 향상
- 실시간 안심: 24/7 상태 모니터링 및 즉각적인 알림
- 지능형 알림: 상황별 최적화된 알림 시스템
- 간편한 설정: 직관적인 인터페이스로 기술적 지식 없이도 쉬운 설정
제공되는 API 서비스
| 서비스 | 주요 기능 | 비즈니스 가치 | Swagger |
|---|---|---|---|
| Child Care | 지오펜싱, 속도 제한, 아동 방치 알림 | 가족 안전 브랜드 이미지 강화 | 문서 보기 |
| Vehicle Diagnosis | AI 진단, 예방 정비, 고장 코드 관리 | 정비 비용 절감 및 차량 수명 연장 | 문서 보기 |
| Vehicle Information | 실시간 상태, 운행 분석, 배터리 관리 | 데이터 기반 개인화 서비스 제공 | 문서 보기 |
| Remote Control | 원격 제어, 스마트 모빌리티 | 차세대 스마트카 경험 제공 | 문서 보기 |
| Customer Safety | ACN, RSA, SOS 긴급 대응 시스템 | 생명 보호 가치 및 안전 브랜드 강화 | 문서 보기 |
| Vehicle Security | 도난 방지, 실시간 추적, 원격 제어 | 차량 자산 보호 및 안심 서비스 | 문서 보기 |
기술적 특징
🔧 기술 통합
- 실시간 처리: 저지연 서버 아키텍처로 즉각적인 응답 제공
- 데이터 보안: 개인정보보호법 준수 및 위치 정보 암호화
- 글로벌 지원: 다국어 지원 및 다국가 규제 대응
📊 서비스 운영
- 확장성: 다수 차량 동시 처리 및 대규모 데이터 관리
- 안정성: 99.9% 이상 서비스 가용성 보장
- 모니터링: 24/7 시스템 상태 감시 및 이상 감지
빠른 시작 가이드
1. 인증 설정
bash
# 테스트용 토큰으로 API 호출
curl -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
"https://api.ecarus.run/api/v1/vehicles/KMHSH81C7LU123456/status"2. 샘플 VIN
테스트용 샘플 차량 번호: KMHSH81C7LU123456
3. 첫 API 호출
Child Care API로 시작하여 아동 안전 기능을 테스트해보세요.
기본 URL
모든 API 요청은 다음 주소로 전송됩니다:
https://api.ecarus.run/api/v1인증
ECARUS API는 **Bearer 인증(JWT)**을 사용합니다. 인증 헤더에 토큰을 포함하세요:
Authorization: Bearer <YOUR_TOKEN>테스트용 토큰
테스트를 위해 다음의 사전 승인된 토큰을 사용할 수 있습니다: sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d
대화형 API 탐색
각 API 서비스 페이지에는 대화형 테스트를 위한 Swagger UI가 포함되어 있습니다. 다음 기능을 활용할 수 있습니다:
- 사용 가능한 모든 엔드포인트 탐색
- 요청/응답 스키마 확인
- 브라우저에서 직접 API 호출 테스트
추가 지원
📚 다국어 지원
- 한국어: 현재 보고 계신 문서
- English: English API Reference (영어 버전)
🔧 기술 지원
- 문의처: developer@dasandmc.com
- 응답시간: 평일 24시간 내 응답 보장
📖 용어 사전
- VIN: Vehicle Identification Number (차량 식별 번호)
- DTC: Diagnostic Trouble Code (고장 진단 코드)
- SSE: Server-Sent Events (실시간 이벤트 스트림)