원격 TPMS 점검 API 개발자 가이드

서비스 개요

원격 타이어 공기압 모니터링 시스템(TPMS) 서비스는 사용자가 모바일 앱이나 웹 플랫폼을 통해 원격으로 차량의 타이어 공기압을 모니터링하고 알림을 받을 수 있는 텔레매틱스 서비스입니다.

서비스 특징

실시간 타이어 공기압 모니터링
타이어 공기압 알림 및 경고
타이어 온도 모니터링
타이어 건강 상태 추적
정비 권장 사항

법적 요구사항

개인정보 보호법 준수
센서 데이터 수집에 대한 명시적 동의 필요
데이터 보유 정책 준수
안전 규정 준수

주요 시나리오

시나리오 1: 타이어 공기압 업데이트 요청 및 처리

엔티티별 API 흐름:

📱 앱 (사용자):

TPMS 요청: 타이어 공기압 업데이트 요청
상태 확인: TPMS 업데이트 상태 확인 (진행 중/완료)
알림 수신: 타이어 공기압 알림 통지 수신

🚗 차량 (TCU):

센서 데이터 수집: 모든 센서로부터 타이어 공기압 및 온도 데이터 수집
데이터 전송: 서버로 센서 데이터 전송
이상 감지: 비정상적인 타이어 공기압 상태 감지

🏢 콜센터:

중복 요청 방지: 중복 요청 방지 로직 적용
명령 전송: 차량으로 TPMS 업데이트 명령 전송
데이터 처리: 수신된 센서 데이터 처리 및 검증
알림 생성: 타이어 공기압 알림 생성
저장: 타임스탬프와 함께 센서 데이터 저장

시나리오 2: 실시간 타이어 공기압 조회

엔티티별 API 흐름:

📱 앱 (사용자):

TPMS 조회: 현재 타이어 공기압 상태 조회
공기압 표시: 모든 타이어의 공기압 표시
상태 표시: 타이어 공기압 상태 인디케이터 표시

🏢 콜센터:

TPMS 제공: 최신 타이어 공기압 상태 제공
상태 관리: 타이어 공기압 상태 자동 관리
데이터 캐싱: 센서 데이터의 효율적 캐싱
상태 분석: 타이어 공기압 패턴 분석

시나리오 3: 타이어 공기압 이력 조회

엔티티별 API 흐름:

📱 앱 (사용자):

이력 조회: 타이어 공기압 이력 조회
이력 표시: 타이어 공기압 이력 차트 표시
추이 분석: 타이어 공기압 추이 분석 표시

🏢 콜센터:

이력 관리: 타이어 공기압 이력 자동 관리
패턴 분석: 타이어 공기압 패턴 분석
통계 생성: 타이어 공기압 통계 생성

시나리오 4: 타이어 공기압 알림 및 경고

엔티티별 API 흐름:

📱 앱 (사용자):

알림 설정: 타이어 공기압 알림 설정
알림 수신: 타이어 공기압 알림 통지 수신
알림 관리: 알림 기본 설정 관리

🏢 콜센터:

알림 모니터링: 알림 조건에 대한 타이어 공기압 모니터링
알림 생성: 타이어 공기압 알림 생성
푸시 알림: 사용자 앱으로 푸시 알림 전송
에스컬레이션: 심각한 알림은 콜센터로 에스컬레이션

시나리오 5: 타이어 건강 분석

엔티티별 API 흐름:

📱 앱 (사용자):

TPMS 조회: 현재 타이어 공기압 상태 조회
공기압 추이 조회: 타이어 공기압 이력 추이 조회
TPMS 확인 요청: 실시간 타이어 공기압 업데이트 요청

🏢 콜센터:

이벤트 스트림 제공: 실시간 TPMS 이벤트 스트림 제공
이벤트 전송: 실시간으로 TPMS 변경 이벤트 전송

시나리오 7: 타이어 공기압 캘리브레이션

엔티티별 API 흐름:

📱 앱 (사용자):

알림 설정 업데이트: 타이어 공기압 알림 및 임계치 설정
알림 결과: 타이어 공기압 이상 감지 시 알림 수신

🏢 콜센터:

캘리브레이션 처리: 타이어 공기압 캘리브레이션 요청 처리
캘리브레이션 실행: 캘리브레이션 절차 실행
캘리브레이션 검증: 캘리브레이션 결과 검증

주요 기능

📱 앱 구현 기능

1. 타이어 공기압 모니터링

공기압 조회: 현재 타이어 공기압 즉시 조회
공기압 표시: 모든 타이어의 공기압 표시
상태 인디케이터: 타이어 공기압 상태 인디케이터 표시
실시간 업데이트: 실시간 타이어 공기압 업데이트
온도 표시: 타이어 온도 정보 표시

2. 타이어 공기압 이력

이력 조회: 타이어 공기압 이력 조회
차트 표시: 타이어 공기압 이력 차트 표시
추이 분석: 타이어 공기압 추이 분석 표시
통계: 타이어 공기압 통계 표시

3. 알림 및 통지

알림 설정: 타이어 공기압 알림 설정
알림 수신: 타이어 공기압 알림 통지 수신
알림 관리: 알림 기본 설정 관리
알림 이력: 알림 이력 표시

4. 타이어 건강 분석

건강 조회: 타이어 건강 분석 및 추이 조회
건강 표시: 타이어 건강 상태 표시
권장 사항: 정비 권장 사항 표시
건강 추적: 시간 경과에 따른 타이어 건강 추적

5. 캘리브레이션 및 설정

업데이트 요청: 실시간 타이어 공기압 업데이트 요청
설정 관리: TPMS 설정 관리
센서 상태: 센서 상태 정보 표시

6. 실시간 이벤트 수신

업데이트 요청: 실시간 타이어 공기압 업데이트 요청
수동 점검: 수동 타이어 공기압 센서 읽기 시작

🏢 콜센터 구현 기능

1. TPMS 데이터 수집 시스템

데이터 수신: 실시간 타이어 공기압 데이터 수신
데이터 저장: 센서 데이터의 안전한 저장
TPMS 관리: 최신 TPMS 데이터 자동 관리
품질 관리: 센서 데이터 품질 및 정확성 관리
데이터 검증: 센서 데이터 유효성 검증

2. TPMS 이력 관리 시스템

이력 수집: 타이어 공기압 이력 자동 수집
이력 관리: TPMS 이력 자동 관리
패턴 분석: 타이어 공기압 패턴 자동 분석
통계 생성: 타이어 공기압 통계 자동 생성

3. 알림 및 경고 시스템

알림 모니터링: 알림 조건에 대한 타이어 공기압 모니터링
알림 생성: 타이어 공기압 알림 자동 생성
푸시 알림: 사용자 앱으로 푸시 알림 자동 전송
알림 에스컬레이션: 심각한 알림을 콜센터로 에스컬레이션
알림 설정: 알림 설정 관리

4. 타이어 건강 분석 시스템

건강 분석: 타이어 건강 자동 분석
권장 사항 생성: 정비 권장 사항 생성
건강 추적: 시간 경과에 따른 타이어 건강 추적
예측 분석: 타이어 정비 요구 사항 예측

5. 캘리브레이션 시스템

업데이트 처리: 실시간 업데이트 요청 처리
캘리브레이션 실행: 캘리브레이션 절차 실행
캘리브레이션 검증: 캘리브레이션 결과 검증
캘리브레이션 이력: 캘리브레이션 이력 관리

6. API 서비스 관리

API 응답 처리: TPMS 관련 API 요청 처리
요청 검증: API 요청 유효성 검증
성능 모니터링: API 응답 시간 및 가용성 모니터링
에러 핸들링: API 에러 및 예외 처리
버전 관리: API 버전 및 호환성 관리

7. 보안 및 프라이버시

센서 데이터 동의: 센서 데이터 수집 동의 관리
프라이버시 보호: 사용자 센서 데이터 프라이버시 보호
데이터 보안: 센서 데이터의 안전한 처리
감사 로깅: 센서 데이터 접근에 대한 감사 로그 유지
접근 제어: 사용자별 TPMS 접근 권한 관리

8. 시스템 운영 및 모니터링

시스템 상태 모니터링: TPMS 시스템 24시간 모니터링
데이터 품질 관리: 센서 데이터 품질 및 정확성 관리
센서 상태 모니터링: TPMS 센서 통신 상태 모니터링
예외 처리: 네트워크, 센서, 데이터 처리 예외 대응
시스템 최적화: TPMS 데이터 처리 로직 최적화

9. 데이터 분석 및 통계

패턴 분석: 타이어 공기압 패턴 자동 분석
이용 통계: TPMS 이용 통계 자동 생성
서비스 품질 분석: TPMS 서비스 품질 자동 분석
개선 권장 사항: 서비스 개선 권장 사항 자동 생성

시퀀스 다이어그램

원격 TPMS 시스템 흐름

원격 TPMS

API 엔드포인트

헤더, 응답 코드 및 에러 형식은 공통 API 사양을 참조하십시오.

타이어 공기압 이력 조회

bash

curl -X GET "https://api.ecarus.run/api/v1/information/vehicles/KMHSH81C7LU123456/tpms/trend?limit=10" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d"

타이어 공기압 업데이트 요청

bash

curl -X POST "https://api.ecarus.run/api/v1/information/vehicles/KMHSH81C7LU123456/tpms/check" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Content-Type: application/json" \
     -d '{"priority": "HIGH", "timeout": 30}'

타이어 공기압 알림 설정

bash

curl -X PUT "https://api.ecarus.run/api/v1/information/vehicles/KMHSH81C7LU123456/tpms/alerts" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Content-Type: application/json" \
     -d '{"lowPressureThreshold": 28, "highPressureThreshold": 35, "temperatureThreshold": 70}'

데이터 모델

타이어 공기압 정보 응답

json

{
  "vin": "KMHSH81C7LU123456",
  "userId": "user123",
  "timestamp": "2026-01-13T14:30:00Z",
  "tpms": {
    "frontLeft": {
      "pressure": 32.5,
      "temperature": 25.5,
      "status": "NORMAL",
      "lastUpdate": "2026-01-13T14:30:00Z",
      "sensorId": "TPMS-001",
      "batteryLevel": 85
    },
    "frontRight": {
      "pressure": 32.8,
      "temperature": 26.2,
      "status": "NORMAL",
      "lastUpdate": "2026-01-13T14:30:00Z",
      "sensorId": "TPMS-002",
      "batteryLevel": 82
    },
    "rearLeft": {
      "pressure": 31.9,
      "temperature": 24.8,
      "status": "NORMAL",
      "lastUpdate": "2026-01-13T14:30:00Z",
      "sensorId": "TPMS-003",
      "batteryLevel": 88
    },
    "rearRight": {
      "pressure": 32.2,
      "temperature": 25.1,
      "status": "NORMAL",
      "lastUpdate": "2026-01-13T14:30:00Z",
      "sensorId": "TPMS-004",
      "batteryLevel": 79
    }
  },
  "system": {
    "overallStatus": "NORMAL",
    "lastCalibration": "2025-12-01T10:00:00Z",
    "nextCalibration": "2026-06-01T10:00:00Z",
    "sensorCount": 4,
    "activeSensors": 4
  },
  "alerts": [
    {
      "alertId": "alert-001",
      "type": "LOW_PRESSURE",
      "severity": "MEDIUM",
      "tire": "rearLeft",
      "message": "왼쪽 뒷바퀴 공기압이 권장 수준보다 낮습니다.",
      "currentPressure": 28.5,
      "recommendedPressure": 32.0,
      "timestamp": "2026-01-13T14:30:00Z",
      "acknowledged": false
    }
  ]
}

타이어 공기압 이력 응답

json

{
  "vin": "KMHSH81C7LU123456",
  "userId": "user123",
  "period": "30d",
  "limit": 10,
  "offset": 0,
  "history": [
    {
      "readingId": "reading-001",
      "timestamp": "2026-01-13T14:30:00Z",
      "tpms": {
        "frontLeft": {"pressure": 32.5, "temperature": 25.5},
        "frontRight": {"pressure": 32.8, "temperature": 26.2},
        "rearLeft": {"pressure": 31.9, "temperature": 24.8},
        "rearRight": {"pressure": 32.2, "temperature": 25.1}
      },
      "overallStatus": "NORMAL",
      "drivingCondition": "PARKED"
    },
    {
      "readingId": "reading-002",
      "timestamp": "2026-01-13T09:15:00Z",
      "tpms": {
        "frontLeft": {"pressure": 33.2, "temperature": 28.5},
        "frontRight": {"pressure": 33.5, "temperature": 29.1},
        "rearLeft": {"pressure": 32.8, "temperature": 27.8},
        "rearRight": {"pressure": 33.1, "temperature": 28.2}
      },
      "overallStatus": "NORMAL",
      "drivingCondition": "DRIVING"
    }
  ],
  "total": 720,
  "hasMore": true,
  "nextOffset": 10
}

타이어 공기압 알림 설정 응답

json

{
  "vin": "KMHSH81C7LU123456",
  "userId": "user123",
  "timestamp": "2026-01-13T14:30:00Z",
  "alerts": {
    "pressure": {
      "lowPressureThreshold": 28.0,
      "highPressureThreshold": 35.0,
      "rapidDropThreshold": 2.0,
      "unit": "PSI"
    },
    "temperature": {
      "highTemperatureThreshold": 70.0,
      "rapidRiseThreshold": 10.0,
      "unit": "CELSIUS"
    },
    "notifications": {
      "pushEnabled": true,
      "emailEnabled": false,
      "smsEnabled": false,
      "severityFilter": ["MEDIUM", "HIGH", "CRITICAL"]
    },
    "schedule": {
      "monitoringEnabled": true,
      "quietHours": {
        "start": "22:00",
        "end": "07:00",
        "criticalAlertsEnabled": true
      }
    }
  },
  "previousSettings": {
    "pressure": {
      "lowPressureThreshold": 29.0,
      "highPressureThreshold": 36.0
    }
  },
  "validation": {
    "isValid": true,
    "warnings": [
      "낮은 공기압 임계치는 추운 날씨에 빈번한 알림을 유발할 수 있습니다."
    ],
    "errors": []
  }
}

보안 및 프라이버시

인증 및 권한 부여

사용자 인증 토큰 필요 (JWT/OAuth2)
차량 접근 권한 확인
TPMS 조회 권한 확인

데이터 보안

모든 API 통신은 HTTPS/TLS 암호화
센서 데이터의 안전한 전송
민감한 차량 정보 보호

프라이버시 보호

센서 데이터 수집에 대한 명시적 동의
데이터 보유 정책 준수
사용자 요청 시 데이터 삭제 권한 보장

접근 제어

VIN 기반 차량 접근 권한 확인
사용자별 TPMS 접근 권한 관리
이상 접근 패턴 감지

예외 처리

네트워크 관련

연결 실패: 오프라인 모드 지원, 마지막 센서 데이터 캐싱
응답 지연: 로딩 인디케이터, 타임아웃 처리
서버 다운: 에러 메시지 표시, 재시도 제안

센서 관련

센서 오작동: 센서 오작동 알림
센서 배터리 저하: 센서 배터리 저하 알림
센서 통신 오류: 센서 통신 오류 알림

TPMS 관련

비정상 공기압: 비정상 공기압 알림
급격한 공기압 변화: 급격한 공기압 변화 알림
고온 발생: 타이어 고온 발생 알림

권한 관련

인증 실패: 재인증 요청
권한 부족: 권한 부족에 대한 명확한 설명 제공
TPMS 접근 권한: TPMS 접근 권한 부족 알림

테스트 설정

Base URL: https://api.ecarus.run/api/v1/information
인증 토큰: sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d
샘플 VIN: KMHSH81C7LU123456

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

배포 고려사항

앱 스토어 등록

센서 데이터 수집 권한 요청
푸시 알림 권한 요청
TPMS 모니터링 기능에 대한 명확한 설명

법규 준수

개인정보 보호법 준수
센서 데이터 수집에 대한 명시적 동의 필요
데이터 보유 정책 준수
안전 규정 준수

차량 호환성

다양한 차종 지원
다양한 TPMS 센서 유형 지원
OEM별 TPMS 구현 차이 반영 고려
센서 통신 프로토콜 차이 반영 고려

원격 TPMS 점검 API 개발자 가이드 ​

서비스 개요 ​

서비스 특징 ​

법적 요구사항 ​

주요 시나리오 ​

시나리오 1: 타이어 공기압 업데이트 요청 및 처리 ​

시나리오 2: 실시간 타이어 공기압 조회 ​

시나리오 3: 타이어 공기압 이력 조회 ​

시나리오 4: 타이어 공기압 알림 및 경고 ​

시나리오 5: 타이어 건강 분석 ​

시나리오 7: 타이어 공기압 캘리브레이션 ​

주요 기능 ​

📱 앱 구현 기능 ​

1. 타이어 공기압 모니터링 ​

2. 타이어 공기압 이력 ​

3. 알림 및 통지 ​

4. 타이어 건강 분석 ​

5. 캘리브레이션 및 설정 ​

6. 실시간 이벤트 수신 ​

🏢 콜센터 구현 기능 ​

1. TPMS 데이터 수집 시스템 ​

2. TPMS 이력 관리 시스템 ​

3. 알림 및 경고 시스템 ​

4. 타이어 건강 분석 시스템 ​

5. 캘리브레이션 시스템 ​

6. API 서비스 관리 ​

7. 보안 및 프라이버시 ​

8. 시스템 운영 및 모니터링 ​

9. 데이터 분석 및 통계 ​

시퀀스 다이어그램 ​

원격 TPMS 시스템 흐름 ​

API 엔드포인트 ​

최신 타이어 공기압 조회 ​

타이어 공기압 이력 조회 ​

타이어 공기압 업데이트 요청 ​

타이어 공기압 알림 설정 ​

데이터 모델 ​

타이어 공기압 정보 응답 ​

타이어 공기압 이력 응답 ​

타이어 공기압 알림 설정 응답 ​

보안 및 프라이버시 ​

인증 및 권한 부여 ​

데이터 보안 ​

프라이버시 보호 ​

접근 제어 ​

예외 처리 ​

네트워크 관련 ​

센서 관련 ​

TPMS 관련 ​

권한 관련 ​

테스트 설정 ​

배포 고려사항 ​

앱 스토어 등록 ​

법규 준수 ​

차량 호환성 ​

원격 TPMS 점검 API 개발자 가이드

서비스 개요

서비스 특징

법적 요구사항

주요 시나리오

시나리오 1: 타이어 공기압 업데이트 요청 및 처리

시나리오 2: 실시간 타이어 공기압 조회

시나리오 3: 타이어 공기압 이력 조회

시나리오 4: 타이어 공기압 알림 및 경고

시나리오 5: 타이어 건강 분석

시나리오 7: 타이어 공기압 캘리브레이션

주요 기능

📱 앱 구현 기능

1. 타이어 공기압 모니터링

2. 타이어 공기압 이력

3. 알림 및 통지

4. 타이어 건강 분석

5. 캘리브레이션 및 설정

6. 실시간 이벤트 수신

🏢 콜센터 구현 기능

1. TPMS 데이터 수집 시스템

2. TPMS 이력 관리 시스템

3. 알림 및 경고 시스템

4. 타이어 건강 분석 시스템

5. 캘리브레이션 시스템

6. API 서비스 관리

7. 보안 및 프라이버시

8. 시스템 운영 및 모니터링

9. 데이터 분석 및 통계

시퀀스 다이어그램

원격 TPMS 시스템 흐름

API 엔드포인트

최신 타이어 공기압 조회

타이어 공기압 이력 조회

타이어 공기압 업데이트 요청

타이어 공기압 알림 설정

데이터 모델

타이어 공기압 정보 응답

타이어 공기압 이력 응답

타이어 공기압 알림 설정 응답

보안 및 프라이버시

인증 및 권한 부여

데이터 보안

프라이버시 보호

접근 제어

예외 처리

네트워크 관련

센서 관련

TPMS 관련

권한 관련

테스트 설정

배포 고려사항

앱 스토어 등록

법규 준수

차량 호환성