CARSTREAM
UA EN
Дашборд
ACTIONS API · WEBHOOKS

Твоє авто — тепер і в твоєму коді

CarStream надсилає події авто на твій сервер у момент, коли вони стаються: поїздка почалась чи завершилась, спрацювало правило, авто перетнуло геозону, з'явилась помилка двигуна. Підписані webhook-и, токен без строку дії, приклади, які можна запустити за хвилину.

Отримати API-токен Документація API →
Подія в авто Поїздка, геозона, перевищення, помилка двигуна
Хмара CarStream Тієї ж миті, що й push на телефон, формує подію для твоїх хуків
Твій сервер Підписаний POST із повним JSON — перевір HMAC і роби своє
Твоя автоматизація Бот у Telegram, розумний дім, таблиця пробігу — що завгодно
ЯК ВЛАШТОВАНА ДОСТАВКА

Один POST — і вся подія у тебе

Кожна доставка — це JSON-конверт з унікальним id, типом події, твоїм авто та даними. Тіло підписане HMAC-SHA256 секретом твого webhook-а, тож підробити запит неможливо.

✓Підпис X-CarStream-Signature на кожній доставці — перевіряється двома рядками коду
✓Відповів 2xx за 10 секунд — доставлено; 3 невдачі поспіль — хук вимикається сам
✓Токен без строку дії з перегенерацією в один клік на сторінці API
POST /carstream/hook
X-CarStream-Event: trip.ended
X-CarStream-Signature: sha256=1f8ac10f…
Content-Type: application/json

{
  "type": "trip.ended",
  "car": { "name": "BMW 530d" },
  "data": {
    "distance_km": 23.4,
    "max_speed_kmh": 92,
    "duration_min": 31.5
  }
}
ПОДІЇ

Все, про що твоє авто вміє розповісти

trip.startedАвто почало рух
trip.endedПоїздка завершена: дистанція, швидкості, тривалість
violation.speedСпрацювало твоє правило ліміту швидкості
violation.camera_speedingПеревищення біля камери швидкості
geofence.enteredАвто в'їхало в геозону
geofence.exitedАвто покинуло геозону
dtc.detectedНові коди несправностей двигуна
webhook.testПеревірочний ping під час реєстрації хука
ЩО НА ЦЬОМУ БУДУЮТЬ

Чотири автоматизації, які пишуться за вечір

Розумний дім зустрічає тебе

Home Assistant отримує подію, коли авто в'їжджає в домашню геозону — ворота відчиняються, світло у дворі вмикається ще до того, як ти припаркувався.

geofence.entered
Бот звітує в чат

Після кожної поїздки Telegram- чи Slack-бот скидає в сімейний або робочий чат коротке зведення: маршрут завершено, 23 км, максимум 92 км/год.

trip.ended
Журнал пробігу сам себе веде

Кожна завершена поїздка стає рядком у Google Sheets — дата, дистанція, тривалість. Звіт для бухгалтерії чи компенсації пального завжди готовий.

trip.ended
Автопарк без сюрпризів

Нова помилка двигуна на будь-якому авто парку — і в сервісній системі вже відкрита заявка з кодами. Механік знає про проблему раніше за водія.

dtc.detected
ШВИДКИЙ СТАРТ

Перший webhook — за три хвилини

1
Візьми токен

Відкрий сторінку API в застосунку — токен уже чекає, разом із прикладами, куди він підставлений автоматично.

2
Зареєструй URL

Один POST — і CarStream одразу перевірить твій ендпоінт тестовою подією. Відповів 200 — хук активний.

3
Лови події

З наступної поїздки все летить на твій сервер. Статус кожного хука видно на тій самій сторінці.

# зареєструвати webhook — ендпоінт має відповісти 200 на тестовий POST
curl -X POST https://carstream.live/api/actions/webhooks \
  -H "Authorization: Bearer cs_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/carstream/hook"}'

Підключи свою першу автоматизацію

Отримати API-токен Повна документація →