ECARUS API Portal - v1.0.0

한국어

English

한국어

English

Appearance

원격 제어 서비스 (Remote Control Service) ​

차량 원격 제어 및 스마트 모빌리티를 위한 지능형 제어 솔루션입니다. 도어, 엔진, 내부 환경을 포함한 차량의 모든 기능을 원격으로 제어하여 고객에게 차세대 스마트 경험을 제공합니다.

OEM을 위한 비즈니스 가치 ​

🚗 스마트 모빌리티 혁신 ​

  • 차세대 경험: 원격 제어 기능을 통한 스마트카 경험 제공
  • 편의성 극대화: 차량 접근 및 제어에 대한 물리적 제약 제거
  • 안전성 강화: 원격 도어 제어 및 위치 찾기를 통한 안전 성능 향상

💰 신규 수익 모델 ​

  • 프리미엄 제어: 고도화된 원격 제어 기능에 대한 구독형 서비스 제공
  • B2B 솔루션: 렌터카, 카셰어링 및 법인 차량 관리 솔루션 제공
  • 데이터 기반 서비스: 제어 패턴 분석을 통한 맞춤형 서비스 제공

📱 고객 경험 강화 ​

  • 실시간 제어: 언제 어디서나 차량 기능 제어 가능
  • 지능형 자동화: 사용자 패턴 기반의 자동 제어 기능 제공
  • 통합 관리: 단일 앱에서 차량의 모든 기능 관리

서브 모듈 ​

OpenAPI 사양 ​

대화형 API 탐색기

대화형 API 테스트를 위해 Swagger UI를 사용하십시오.

OEM 구현 고려사항 ​

기술적 통합 ​

  • 차량 CAN 통신: 보안 원격 제어를 위한 암호화된 통신 프로토콜 적용
  • 실시간 처리: 즉각적인 제어 응답을 위한 저지연 네트워크 구축
  • 보안 시스템: 다중 요소 인증 및 접근 제어 메커니즘 구축

서비스 운영 ​

  • 신뢰성: 99.9% 이상의 원격 제어 서비스 가동률 보장
  • 글로벌 지원: 다양한 차종 및 국가별 통신 규제 지원
  • 모니터링: 24/7 제어 명령 로그 기록 및 이상 징후 감지

대상 고객 ​

  • 기본 타겟: 스마트카 기능에 관심 있는 개인 고객
  • 확장 타겟: 렌터카, 카셰어링 및 법인 차량 관리 업체
  • B2B 기회: 차량 관리 회사, 주차 서비스, 보안 솔루션 업체

주요 기능 ​

  • 원격 도어 제어: 모든 차량 도어의 잠금/해제 및 상태 관리
  • 원격 엔진 제어: 시동 시작/종료 및 상태 모니터링
  • 원격 실내 환경 제어: 공조 시스템 제어 및 온도 설정
  • 원격 위치 찾기: 경적 및 비상등을 이용한 차량 위치 확인
  • 원격 바디 제어: 선루프, 트렁크, 창문 등 바디 전반의 원격 제어

공통 API 사양 ​

모든 원격 제어 API는 공통된 헤더, 응답 코드 및 에러 형식을 공유합니다.

공통 헤더 ​

헤더값설명
AuthorizationBearer {token}사용자 인증 토큰 (JWT/OAuth2)
Content-Typeapplication/json요청/응답 본문 형식
Acceptapplication/json기대하는 응답 본문 형식

공통 응답 코드 ​

상태 코드설명
200 OK요청이 성공적으로 처리되었습니다.
201 Created리소스가 성공적으로 생성되었습니다 (예: 갱신 요청).
202 Accepted백그라운드 처리를 위해 요청이 수락되었습니다.
400 Bad Request유효하지 않은 입력 파라미터입니다.
401 Unauthorized인증 토큰이 누락되었거나 유효하지 않습니다.
403 Forbidden해당 차량에 대한 접근 권한이 없습니다.
404 Not Found지정된 차량(VIN) 또는 리소스를 찾을 수 없습니다.
429 Too Many Requests요청 제한을 초과했습니다 (중복 요청 방지).
500 Internal Server Error서버 측에서 에러가 발생했습니다.

에러 응답 형식 ​

json
{
  "code": "ERROR_CODE",
  "message": "사용자가 이해할 수 있는 에러 메시지",
  "details": {
    "requestId": "고유 요청 ID",
    "timestamp": "2026-01-13T14:30:00Z"
  }
}

API 엔드포인트 ​

도어 제어 (Door Control) ​

모든 차량 도어의 잠금/해제 및 상태 관리 기능을 제공합니다.

엔진 제어 (Engine Control) ​

원격 시동/정지 및 차량 엔진 상태 모니터링 기능을 제공합니다.

실내 환경 제어 (Interior Environment Control) ​

원격으로 차량 공조 시스템을 제어하고 선호 설정을 관리합니다.

차량 위치 확인 (Vehicle Location Check) ​

차량의 위치를 추적하고 관리하는 기능을 제공합니다.

바디 제어 (Body Control) ​

선루프, 트렁크, 창문 등 차량 바디 파츠를 원격으로 제어합니다.

선루프 제어 ​

트렁크 제어 ​

창문 제어 ​

SSE 엔드포인트 (결과 상태 업데이트) ​

제어 작업이 완료될 때까지 상태 변경 사항을 실시간으로 전송합니다.

엔드포인트설명
/remotecontrol/vehicles/{vin}/climate/updates/stream실내 환경 제어 결과의 실시간 업데이트
/remotecontrol/vehicles/{vin}/door/updates/stream도어 제어 결과의 실시간 업데이트
/remotecontrol/vehicles/{vin}/engine/updates/stream엔진 제어 결과의 실시간 업데이트
/remotecontrol/vehicles/{vin}/location/updates/stream차량 위치 정보의 실시간 업데이트
/remotecontrol/vehicles/{vin}/sunroof/updates/stream선루프 제어 결과의 실시간 업데이트
/remotecontrol/vehicles/{vin}/trunk/updates/stream트렁크 제어 결과의 실시간 업데이트
/remotecontrol/vehicles/{vin}/window/updates/stream창문 제어 결과의 실시간 업데이트

서비스 통합 가치 ​

🔄 데이터 통합 시너지 ​

  • 통합 제어 허브: 모든 원격 제어 기능을 통합 관리하는 단일 제어 플랫폼 제공
  • 제어 패턴 분석: 사용자 제어 패턴 분석을 통한 맞춤형 서비스 추천
  • 보안 로깅: 모든 제어 명령에 대한 이력 기록 및 보안 탐지 수행

🚀 차별화된 경쟁력 ​

  • 독자적 제어 솔루션: 타사에서 제공하지 않는 통합형 원격 제어 플랫폼
  • 확장성: 향후 추가될 차량 제어 기능과의 용이한 통합 지원
  • 글로벌 표준: 다양한 차종 및 국가별 통신 규제를 지원하는 표준화된 API

본 API에 대한 전체 사양은 Swagger UI의 OpenAPI 사양을 참조하십시오.

Released under the MIT License.

Copyright © 2026 DASANDMC