Skip to main content
This is a test version of the page. To contact the owner, email [email protected]
CarsKeep
🇦🇿 az
🔌 REST API V1 VƏ PROQRAMÇILAR ÜÇÜN VEBHUKLAR

CarsKeep Açıq REST API v1 Platforması

Öz proqramlarınızı, 1C sisteminizi, telematika avadanlıqlarını Bearer JWT təhlükəsizliyi və Zero Lock-in zəmanəti ilə CarsKeep-ə qoşun.

API Sənədlərini Aç

API Arxitekturası və Giriş İcazəsi

Yüksək sürətli API Gateway və Bearer JWT təhlükəsizlik tokenləri

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

Bütün sorğular HTTPS protokolu ilə ötürülür. Xidmət tokeni sahibkarın idarəetmə panelində dəqiq səlahiyyətlərlə generasiya olunur. 

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

Əsas REST API v1 Metodları

Avtoservis əməliyyatlarını tam avtomatlaşdırmaq üçün CRUD metodları

1. Onlayn qeydiyyat və müraciətlər

3 routes
POST /api/v1/bookings/slots
Boş qaldırıcı və usta vaxt pəncərələrini əldə etmək
POST /api/v1/bookings/create
Saytdan və ya xəritələrdən növbə yaratmaq
POST /api/v1/leads
Spam əleyhinə Honeypot ilə müraciət qəbulu

2. Təmir sifarişlərinin idarə edilməsi

3 routes
GET /api/v1/repair-orders
Status və tarixlərə görə sifariş-qaimələrin siyahısı
GET /api/v1/repair-orders/:id
Qaimə detalları: işlər, detallar və DVI fotoları
POST /api/v1/repair-orders/:id/status
Sifarişi Kanban sütunları üzrə hərəkət etdirmək

3. FIFO Ehtiyat Hissələri Anbarı

3 routes
GET /api/v1/inventory/items
OEM artikul, ad və VIN-ə görə detal axtarışı
POST /api/v1/inventory/batch-receive
FIFO partiyaları ilə qaimə qəbulu
POST /api/v1/inventory/reserve
Aktiv təmir üçün anbar detalının bron edilməsi

4. Məlumat Azadlığı və Tam İxrac (Zero Lock-in)

1 routes
GET /api/v1/tenants/export/full
Bütün müştəri, maşın və anbar bazasının 1 kliklə JSON formatında tam ixracı

Hadisələr və Canlı Vebhuklar (Webhooks)

Xarici CRM, botlar və analitika sistemləri üçün ani bildirişlər

Vebhuk JSON Nümunəsi:

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 vidcet vasitəsilə yeni qeydiyyat yaradıldı

Müştəri qeydiyyatı
vehicle.checked_in

Avtomobilin ilkin DVI baxışı tamamlandı

Qəbul baxışı
repair_order.estimate_approved

Müştəri WhatsApp-da smetanı təsdiqlədi

Müştəri razılığı
repair_order.completed

Avtomobil təmir olundu və təhvilə hazırdır

İşin bitməsi
payment.fiscalized

Kassa qəbzi uğurla vuruldu və qeydə alındı

Kassa ödənişi

Telematika və OBD-II İnteqrasiyası

Kommersiya avtoparklarından birbaşa peyk telemetriyası qəbulu

Yürüşün Avtomatik Sinxronizasiyası

Hər avtomobilin yürüşü GPS/QLONASS vasitəsilə gündəlik yenilənir, əllə yazmağa ehtiyac yoxdur.

DTC Xəta Kodlarının Oxunması

Check Engine xətası yarandıqda (məsələn, P0300 alışma nasazlığı), sistem avtomatik ustaya qabaqlayıcı zəng tapşırığı verir.

Dəstəklənən trekerlər: Teltonika, Galileosky, StarLine, Ruptela, Navtelecom

Rəsmi Proqramlaşdırma Kitabxanaları (SDK)

TypeScript tipləri və daxili xəta yoxlaması olan hazır paketlər

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+ hazır inteqrasiya kataloqu