# StarLine

Управление автомобилем через StarLine — устройства, GPS-координаты, состояние, дистанционные команды, OBD-диагностика

## Сценарии

### Где сейчас машина
Агент покажет координаты, скорость и время последнего обновления с GPS-модуля комплекса по каждому устройству в аккаунте.

### Состояние и диагностика
Агент проверит охрану, двери и зажигание, уровень топлива, напряжение АКБ и температуру двигателя по данным OBD.

### Дистанционные команды
Агент выполнит команды комплекса — постановку на охрану или прогрев двигателя — после вашего подтверждения в чате.

### Сводка по поездкам
Агент соберёт сводку по расписанию: поездки за день, сработавшие тревоги и параметры, которые просели за неделю.

## Как подключить

### Войдите в my.starline.ru под аккаунтом с машиной
Логин и пароль этого аккаунта StarLine ID понадобятся дальше. Убедитесь, что нужный комплекс виден в списке устройств кабинета: ключи дают доступ только к машинам этого аккаунта.

### Отправьте заявку в разделе «Разработчикам»
Раздел виден только при русском языке интерфейса. Опишите в заявке цели использования API — без описания её не рассматривают. Одобрение придёт письмом; физлицу доступно 1000 запросов в сутки.

### Создайте приложение и скопируйте AppId и Secret
После письма об одобрении вернитесь в «Разработчикам» → «Создать приложение» и заполните форму. На странице появится карточка приложения, на ней и указаны AppId и Secret.

## Частые вопросы

### Как подключить StarLine?
Четырьмя значениями: AppId и Secret приложения, созданного в my.starline.ru → «Разработчикам», плюс логин и пароль аккаунта StarLine ID, в списке устройств которого числится машина. Раздел виден только при русском языке интерфейса, одобрение приходит письмом.

### Что агент видит в StarLine?
Список устройств аккаунта, GPS-координаты и треки, состояние охраны и датчиков, показатели OBD-диагностики и историю событий комплекса.

### Пишет ли агент в StarLine?
Да, коннектор умеет дистанционные команды — например, прогрев двигателя или постановку на охрану. Такие действия агент выполняет только после вашего явного подтверждения.

### Какие ограничения у API?
Физлицу StarLine отдаёт 1000 запросов в сутки, поэтому непрерывный трекинг секунда в секунду не выйдет: агент опрашивает состояние по расписанию или по вашему запросу.

[Открыть StarLine](https://my.starline.ru)