Skip to main content
This is a test version of the page. To contact the owner, email [email protected]
CarsKeep
🇰🇿 kz
🔌 ӘЗІРЛЕУШІЛЕРГЕ АРНАЛҒАН REST API V1 ЖӘНЕ ВЕБХУКТЕР

CarsKeep Ашық REST API v1 Платформасы

Өз бағдарламаларыңызды, 1С жүйесін және телематика құрылғыларын Bearer JWT қауіпсіздігімен CarsKeep экожүйесіне қосыңыз.

API Құжаттамасын ашу

API Архитектурасы және Аутентификация

Қауіпсіз JWT/Bearer токенедері бар жоғары өнімді API Gateway

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

Барлық сұраныстар HTTPS арқылы жүзеге асырылады. Токендер басқару панелінде нақты құқықтармен беріледі. 

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
Боттардан қорғалған өтінімдер қабылдау

2. Наряд-тапсырыстарды басқару

3 routes
GET /api/v1/repair-orders
Мәртебелер мен күндер бойынша нарядтар тізімі
GET /api/v1/repair-orders/:id
Наряд мәліметтері: жұмыстар, бөлшектер және фотолар
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
Барлық клиенттер мен қойма базасын 1 басумен JSON форматында толық жүктеп алу

Оқиғалар және Тікелей Вебхуктер

Сыртқы 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+ дайын интеграциялар каталогы