Child Left-Behind Alert Service Developer Guide

Service Overview

Child Left-Behind Alert Service is a telematics-based service for protecting child safety in vehicles, providing real-time child detection, left-behind situation alerts, and emergency situation management functions.

Service Features

• Real-time child presence detection and monitoring
• Immediate alerts for child left-behind situations in vehicles
• Automatic emergency situation detection and response
• Multi-sensor fusion (car seat, safety belt, motion detection)
• Guardian and emergency service linkage

Legal Requirements

• Compliance with child safety-related regulations
• Compliance with personal information protection laws
• Mandatory consent for vehicle internal sensor data collection
• Compliance with emergency situation handling protocols

Key Scenarios

Scenario 1: Child Left-Behind Alert Setting

API Flow by Entity:

📱 App (User):

1. Enable Alert: Enable alert service and set sensitivity
2. Settings Query: Verify alert settings
3. Acknowledgment: Acknowledge alert notifications

🚗 Vehicle (TCU):

1. Sensor Data Transmission: Transmit location, seat occupancy, and ignition status
2. Status Report: Report current child presence status

🏢 Call Center:

1. Ticket Query: Query emergency ticket
2. Ticket Update: Update rescue operation status

Key Features

App Features

• Alert Enable: Start service monitoring and settings
• Alert Disable: Temporary service stop
• Alert Query: Check current service enable status
• Alert Acknowledgment: Acknowledge alert and input actions
• Alert Details: Check specific alert detailed information
• Real-time Monitoring: Receive real-time alerts via SSE stream
• Geofence Registration: Register safe zone geofences

Call Center Features

• Alert Monitoring: Receive real-time alerts via SSE stream
• Ticket Management: Manage emergency tickets and Manage emergency tickets
• Guardian Contact: Immediate notification to guardian upon violation
• Emergency Rescue: Automatic emergency ticket generation and response management

Sequence Diagram

Child Left-Behind Alert System Flow

Platform Integration Considerations

Sensor Data Processing

• Real-time sensor data stream processing
• Multi-sensor data fusion algorithms
• Noise filtering and reliability correction
• Sensor error detection and replacement processing

Child Determination Logic

• Multi-condition based child presence determination
• Time-based left-behind situation detection
• Environmental factors (temperature, humidity) consideration
• Hysteresis application for false detection prevention

Alert Priority Management

• Alert classification by risk level
• Sequential alerts to multiple recipients
• Alert acknowledgment tracking
• Re-alert and escalation policies

Emergency Situation Handling

• Automatic emergency service linkage protocols
• Real-time location information sharing
• Emergency ticket lifecycle management
• Real-time rescue operation status monitoring

API Endpoints

Refer to the Common API Specifications for headers, response codes, and error formats.

Child Left-Behind Alert Settings

Child Left-Behind Alert Query

curl -X GET "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/child-alert" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d"

Child Left-Behind Alert Monitoring Enable

curl -X POST "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/child-alert/enable" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Content-Type: application/json" \
     -d '{"enabled": true, "sensitivity": "HIGH", "notifications": ["push", "sms"]}'

Child Left-Behind Alert Monitoring Disable

curl -X POST "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/child-alert/disable" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Content-Type: application/json" \
     -d '{"reason": "Maintenance mode", "disableDuration": "2h"}'

Child Left-Behind Alert Detailed Information

Child Left-Behind Alert Acknowledgment Request

curl -X POST "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/child-alert/left-behind/alert_001/acknowledge" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Content-Type: application/json" \
     -d '{"acknowledgedBy": "parent01", "action": "resolved", "notes": "Child has been verified."}'

Child Left-Behind Alert Detailed Information Query

curl -X GET "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/child-alert/left-behind/alert_001" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d"

Emergency Situation Management for Call Center

Emergency Ticket Query

curl -X GET "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/emergency/tickets/ticket_001" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d"

Emergency Ticket Status Update

curl -X PUT "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/emergency/tickets/ticket_001/status" \
     -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     -H "Content-Type: application/json" \
     -d '{"status": "resolved", "updatedBy": "operator01", "resolution": "Rescue completed"}'

Child Left-Behind Real-time Event Reception (SSE)

Note: Recommend accessing via browser or using dedicated SSE client

curl -N -H "Authorization: Bearer sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d" \
     "https://api.ecarus.run/api/v1/childcare/vehicles/KMHSH81C7LU123456/child-alert/events"

Data Models

Child Left-Behind Alert Status

Alert service enable status query response model

{
  "vin": "KMHSH81C7LU123456",
  "enabled": true,
  "sensitivity": "HIGH",
  "notifications": ["push", "sms"],
  "lastDetection": {
    "timestamp": "2026-01-13T14:30:00Z",
    "confidence": 0.95,
    "sensors": ["child_seat", "rear_belt", "motion"]
  },
  "createdAt": "2026-01-10T10:00:00Z",
  "updatedAt": "2026-01-13T14:30:00Z"
}

Child Left-Behind Alert Enable Request

Alert service enable request model

{
  "enabled": true,
  "sensitivity": "HIGH",
  "notifications": ["push", "sms"]
}

Child Left-Behind Alert Disable Request

Alert service disable request model

{
  "reason": "Maintenance mode",
  "disableDuration": "2h"
}

Child Left-Behind Alert Event

Alert event generated when child left-behind detected

{
  "alertId": "alert_001",
  "vin": "KMHSH81C7LU123456",
  "timestamp": "2026-01-13T14:32:00Z",
  "severity": "HIGH",
  "location": {
    "latitude": 37.5665,
    "longitude": 126.9780,
    "accuracy": 5.0,
    "address": "2 Taepyeong-ro, Jung-gu, Seoul"
  },
  "vehicleStatus": {
    "ignition": "OFF",
    "temperature": 35.5,
    "childDetected": true,
    "engineStatus": "stopped"
  },
  "duration": 120,
  "message": "Child has been left in vehicle. Immediate verification required.",
  "notifiedGuardians": ["parent01", "parent02"],
  "acknowledged": false,
  "createdAt": "2026-01-13T14:32:00Z"
}

Child Left-Behind Alert Detailed Information

Specific alert ID detailed information query response

{
  "alertId": "alert_001",
  "vin": "KMHSH81C7LU123456",
  "timestamp": "2026-01-13T14:32:00Z",
  "severity": "HIGH",
  "status": "ACTIVE",
  "location": {
    "latitude": 37.5665,
    "longitude": 126.9780,
    "accuracy": 5.0,
    "address": "2 Taepyeong-ro, Jung-gu, Seoul"
  },
  "vehicleStatus": {
    "ignition": "OFF",
    "temperature": 35.5,
    "childDetected": true,
    "engineStatus": "stopped",
    "doorLock": "LOCKED"
  },
  "duration": 120,
  "detectionDetails": {
    "confidence": 0.95,
    "sensors": ["child_seat", "rear_belt", "motion"],
    "lastMovement": "2026-01-13T14:30:00Z"
  },
  "message": "Child has been left in vehicle. Immediate verification required.",
  "notifiedGuardians": ["parent01", "parent02"],
  "acknowledged": false,
  "acknowledgedBy": null,
  "acknowledgedAt": null,
  "emergencyTicket": "ticket_001",
  "createdAt": "2026-01-13T14:32:00Z"
}

Alert Acknowledgment Request

Alert acknowledgment processing request model

{
  "acknowledgedBy": "parent01",
  "action": "resolved",
  "notes": "Child safety verification completed"
}

Emergency Ticket

Ticket information generated when emergency situation occurs

{
  "ticketId": "ticket_001",
  "vin": "KMHSH81C7LU123456",
  "alertId": "alert_001",
  "status": "active",
  "severity": "CRITICAL",
  "createdAt": "2026-01-13T14:35:00Z",
  "updatedAt": "2026-01-13T14:40:00Z",
  "resolvedAt": null,
  "location": {
    "latitude": 37.5665,
    "longitude": 126.9780,
    "accuracy": 5.0,
    "address": "2 Taepyeong-ro, Jung-gu, Seoul"
  },
  "assignedTo": "emergency_service_01",
  "estimatedArrival": "2026-01-13T14:45:00Z",
  "actualArrival": null,
  "contactInfo": {
    "phone": "+82-2-1234-5678",
    "email": "emergency@example.com"
  },
  "notes": "Vehicle internal temperature at dangerous levels, immediate rescue required",
  "actions": [
    {
      "timestamp": "2026-01-13T14:35:00Z",
      "action": "DISPATCHED",
      "performedBy": "system",
      "details": "Rescue team dispatched"
    }
  ]
}

Emergency Ticket Status Update Request

Emergency ticket status update request model

{
  "status": "resolved",
  "updatedBy": "operator01",
  "resolution": "Rescue completed"
}

Real-time Alert Event (SSE)

Real-time alert event stream

{
  "eventType": "CHILD_LEFT_BEHIND",
  "alertId": "alert_001",
  "vin": "KMHSH81C7LU123456",
  "timestamp": "2026-01-13T14:32:00Z",
  "severity": "HIGH",
  "data": {
    "location": {
      "latitude": 37.5665,
      "longitude": 126.9780
    },
    "vehicleStatus": {
      "ignition": "OFF",
      "temperature": 35.5,
      "childDetected": true
    },
    "duration": 120,
    "message": "Child left behind in vehicle detected"
  }
}

Authentication and Security

Authentication Requirements

• User authentication token required (JWT/OAuth2)
• Vehicle access permission verification
• Child left-behind alert service setting permission
• Emergency situation handling permission

Security and Privacy

• All API communication encrypted with HTTPS/TLS
• Security measures when transmitting sensor data
• Sensitive information stored only on server
• Special protection for child-related information
• Mandatory location information collection consent

Exception Handling

Sensor Related

• Sensor Error: Error compensation through multi-sensor cross-verification
• Temporary Unavailability: Function replacement with backup sensors
• Noise Occurrence: Reliability correction with filtering algorithms
• Calibration Needed: Notify administrator of sensor calibration

Network Related

• Connection Failure: Basic function operation in offline mode
• Slow Response: Local priority determination then server synchronization
• Server Down: Local alert function operation in emergency situations

Alert Related

• Recipient Non-response: Alert to next recipient according to escalation policy
• Carrier Failure: Simultaneous use of multiple channels (push, SMS, email)
• False Alerts: Minimization with false detection prevention algorithms

---

Test Setup

Base URL: https://api.ecarus.run/api/v1/childcare
Authentication Token: sk_4f9c7b8e2d1a6c0f3e7a9b5d8c1e4f2a7c6d9e0b3f5a8c1d4e7f9b2c6a1e3d
Sample VIN: KMHSH81C7LU123456

Use Swagger UI for interactive API testing.

Additional Support

For technical support during development, refer to the following resources:

• API Documentation: Swagger UI
• Real-time Event Guide: SSE Tutorial
• Technical Inquiries: Developer Portal Support Team