Skip to main content
This is a test version of the page. To contact the owner, email [email protected]
CarsKeep
🇺🇿 uz
🔌 DASTURCHILAR UCHUN REST API V1 VA VEBHUKLAR

CarsKeep Ochiq REST API v1 Platformasi

O'z dasturlaringizni, 1C tizimingizni va telematika uskunalarini Bearer JWT xavfsizligi bilan CarsKeep ekotizimiga ulang.

API Qo'llanmasini ochish

API Arxitekturasi va Autentifikatsiya

JWT/Bearer tokenlari bilan ishlaydigan yuqori tezlikdagi API Gateway

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

Barcha so'rovlar xavfsiz HTTPS orqali yuboriladi. Maxsus tokenlar boshqaruv panelida aniq huquqlar bilan yaratiladi. 

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

Asosiy REST API v1 Metodlari

Avtoservis operatsiyalarini avtomatlashtirish uchun standart CRUD metodlari

1. Onlayn yozilish va arizalar

3 routes
POST /api/v1/bookings/slots
Bo'sh ko'targichlar va ustalar vaqtini olish
POST /api/v1/bookings/create
Sayt yoki xaritalardan navbat yaratish
POST /api/v1/leads
Spamga qarshi himoyalangan arizalar qabul qilish

2. Ta'mir buyurtmalarini boshqarish

3 routes
GET /api/v1/repair-orders
Holatlar va sanalar bo'yicha buyurtmalar ro'yxati
GET /api/v1/repair-orders/:id
Buyurtma tafsilotlari: ishlar, qismlar va DVI suratlari
POST /api/v1/repair-orders/:id/status
Buyurtmani Kanban ustunlari bo'yicha ko'chirish

3. FIFO Ehtiyot Qismlar Ombori

3 routes
GET /api/v1/inventory/items
OEM artikul, nomi va VIN bo'yicha qism qidirish
POST /api/v1/inventory/batch-receive
FIFO partiyalari bilan yuk qabul qilish
POST /api/v1/inventory/reserve
Buyurtmaga ombor qismini band qilish

4. Ma'lumotlar Erkinligi va To'liq Eksport (Zero Lock-in)

1 routes
GET /api/v1/tenants/export/full
Barcha mijozlar va ombor bazasini 1 bosishda JSON formatida yuklab olish

Hodisalar va Jonli Vebhuklar

Tashqi CRM va botlar uchun darhol xabarnomalar

Vebhuk JSON Namunasi:

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

Onlayn vidjet orqali yangi navbat olindi

Mijoz yozilishi
vehicle.checked_in

Avtomobilni qabul qilishdagi DVI ko'rigi yakunlandi

Qabul ko'rigi
repair_order.estimate_approved

Mijoz WhatsApp orqali smetani tasdiqladi

Mijoz roziligi
repair_order.completed

Avtomobil ta'mirlanib, tayyor bo'ldi

Ish yakuni
payment.fiscalized

Chek urildi va to'lov qabul qilindi

Kassa to'lovi

Telematika va OBD-II Integratsiyasi

Tijorat avtoparklaridan to'g'ridan-to'g'ri telemetriya qabul qilish

Yurilgan Masofaning Avtomatik Yangilanishi

Avtomobil yurgan masofasi GPS orqali har kuni avtomatik yangilanadi.

DTC Xato Kodlarini O'qish

Check Engine xatosi chiqqanda (masalan, P0300), tizim ustaga zudlik bilan vazifa yaratadi.

Qo'llab-quvvatlanadigan uskunalar: Teltonika, Galileosky, StarLine, Ruptela, Navtelecom

Rasmiy Dasturlash Paketlari (SDK)

TypeScript tiplariga ega tayyor paketlar

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+ tayyor integratsiyalar katalogi