Skip to main content
This is a test version of the page. To contact the owner, email [email protected]
CarsKeep
🇷🇺 ru
🔌 REST API V1 & WEBHOOKS ДЛЯ РАЗРАБОТЧИКОВ И ИНТЕГРАТОРОВ

Открытый программный интерфейс CarsKeep API v1

Подключайте ваши корпоративные системы, 1С:Бухгалтерию, кастомные приложения и OBD-II телематику к экосистеме CarsKeep с защитой Bearer JWT и гарантией Zero Lock-in.

Открыть документацию API

Архитектура API и Аутентификация

Высокопроизводительный шлюз API Gateway со строгой JWT/Bearer авторизацией

API Base URL Production HTTPS Gateway
https://api.carskeep.com/api/v1/

Все запросы к API выполняются по протоколу HTTPS. Сервисный токен генерируется в панели управления владельца СТО с разграничением прав на уровне Bitset Capabilities. 

curl -X POST "https://api.carskeep.com/api/v1//orders" \
  -H "Authorization: Bearer ck_live_9f8a2e1d4c..." \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "JTDKN36U901234567",
      "plate": "10-AB-420",
      "model": "Toyota Camry 2.5 AT"
    },
    "bayNumber": 2,
    "mileageKm": 68420,
    "customer": {
      "name": "Alexei Ivanov",
      "phone": "+77014205566"
    },
    "services": [
      { "code": "SRV-OIL-01", "name": "Замена масла и фильтра", "hours": 0.8 },
      { "code": "SRV-BRK-02", "name": "Замена передних колодок", "hours": 1.2 }
    ]
  }'
HTTPS 201 Created
auth: bearer_tokengzip: 240b

Ключевые Эндпоинты REST API v1

Стандартизированные CRUD-операции для автоматизации всех звеньев автосервиса

1. Онлайн-запись и лидогенерация

3 routes
POST /api/v1/bookings/slots
Получить свободные временные окна постов и мастеров
POST /api/v1/bookings/create
Создать бронирование визита с сайта или гео-карт
POST /api/v1/leads
Захват лида с промо-страниц с защитой Honeypot

2. Управление заказ-нарядами (Repair Orders)

3 routes
GET /api/v1/repair-orders
Список заказ-нарядов с фильтрацией по статусам и датам
GET /api/v1/repair-orders/:id
Детали наряда: работы, запчасти, DVI фото осмотра
POST /api/v1/repair-orders/:id/status
Перемещение наряда по колонкам Канбан-доски

3. Склад автозапчастей FIFO

3 routes
GET /api/v1/inventory/items
Поиск деталей по OEM-артикулу, наименованию и VIN
POST /api/v1/inventory/batch-receive
Оприходование накладной поставщика партиями FIFO
POST /api/v1/inventory/reserve
Резервирование детали под открытый заказ-наряд

4. Свобода данных и экспорт (Zero Lock-in)

1 routes
GET /api/v1/tenants/export/full
Полный криптографический дамп всех баз клиентов, авто и склада в формате JSON в 1 клик

События и Двусторонние Вебхуки (Webhooks)

Мгновенные оповещения внешних CRM, мессенджеров и систем аналитики

Пример JSON-полезной нагрузки вебхука:

event: ro.status_changed 
{
  "event": "repair_order.estimate_approved",
  "timestamp": "2026-09-30T10:14:22Z",
  "tenant_id": "ten_baku_4021",
  "data": {
    "repair_order_id": "ro_94021",
    "customer": {
      "name": "Рамиль Мамедов",
      "phone": "+994502000000"
    },
    "vehicle": {
      "vin": "KMHD381UBJU194021",
      "license_plate": "10-AB-402",
      "model": "Kia Sportage 2021"
    },
    "approved_amount": 155.00,
    "currency": "AZN",
    "approved_items": [
      { "type": "part", "code": "54813-2S000", "title": "Втулка стабилизатора", "qty": 2, "price": 20.00 },
      { "type": "labor", "code": "L-SU-04", "title": "Замена втулок стабилизатора", "hours": 0.8, "price": 35.00 }
    ]
  }
}
booking.created

Создана новая бронь через онлайн-виджет на картах

Запись клиента
vehicle.checked_in

Завершен первичный DVI-осмотр кузова при заезде на СТО

Осмотр приемщика
repair_order.estimate_approved

Клиент нажал кнопку согласования сметы в WhatsApp

Согласие клиента
repair_order.completed

Автомобиль прошел ОТК и готов к выдаче клиенту

Готовность машины
payment.fiscalized

Успешная фискализация чека в онлайн-кассе ОФД

Оплата в кассе

Интеграция с Телематикой и OBD-II Сканерами

Прямой прием телеметрии от бортовых трекеров коммерческих автопарков

Автоматическая синхронизация пробега

Пробег каждого автомобиля в карточке обновляется ежесуточно по данным спутников GPS/ГЛОНАСС без ручного ввода мастером.

Считывание кодов ошибок DTC

При появлении Check Engine (например, пропуски зажигания P0300) система автоматически формирует задачу мастеру-приемщику на превентивный звонок водителю.

Поддерживаемые трекеры: Teltonika, Galileosky, StarLine, Ruptela, Navtelecom

Официальные Клиентские SDK

Готовые библиотеки с типизацией TypeScript и валидацией схем

v1.4.0 • Zero DB Import

Node.js / TypeScript

npm install @carskeep/api-sdk
v1.2.0 • Asyncio ready

Python

pip install carskeep-sdk
REST OpenAPI 3.0

cURL / HTTP

curl -H "Authorization: Bearer token" https://api.carskeep.com
Каталог 45+ готовых интеграций