Hamkorlar uchun API va vidjet

Kalit va limitlar

Har bir so‘rov Authorization: Bearer vk_live_… sarlavhasidagi kalit bilan. Kalit bizda faqat xesh ko‘rinishida saqlanadi: yo‘qotsangiz — yangisini beramiz.

• Har bir kalitning daqiqa va sutkalik limitlari bor. Qoldiq — X-RateLimit-Remaining va X-RateLimit-Day-Remaining sarlavhalarida; oshib ketsa — 429 javobi va Retry-After.
• Har bir so‘rov jurnalga yoziladi: javob vaqti, holat, mamlakat, tariflar versiyasi.
• Kalitni menejer beradi — bizga yozing

Kalit topshirish narxi: POST /api/v1/quote

Mashina ma’lumotlarini (marka, yil, sotuvchi narxi von yoki yuanda, hajm, quvvat, yoqilg‘i) va mijoz mamlakatini yuboring; shahar — ixtiyoriy.

curl -X POST https://core8global.com/api/v1/quote \
  -H "Authorization: Bearer vk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"country":"KZ","city":"almaty","car":{"make":"Kia","model":"Sorento","year":2022,"price":31500000,"currency":"KRW","engineCc":2151,"powerHp":202,"fuel":"diesel"}}'

Javob:

{
  "quote": {
    "ok": true,
    "currency": "KZT",
    "totalMinor": 1534561400,
    "totalText": "≈ 15 345 614 ₸",
    "preliminary": true,
    "groups": [{ "key": "car", "minor": 1170000000, … }, …],
    "lines": [ … ],
    "days": { "min": 21, "max": 35 }
  },
  "tariff": { "version": "kz-3f9a1c2b", "ratesAsOf": "2026-10-12", "rules": 14, "unverified": 3 }
}

• Summalar — mamlakat valyutasining eng kichik birliklarida butun sonlar + locale tilidagi tayyor totalText qatori.
• Ma’lumot yetmasa (masalan, RF uchun quvvat), quote.ok = false, quote.missing’da esa nima kerakligi.
• car o‘rniga lotId — katalogimizdagi mashina raqamini yuborish mumkin.

Tariflar versiyasi

Har bir javobda va X-Tariff-Version sarlavhasida mamlakat tariflari versiyasi bor. Bojxona stavkalari, mamlakat sozlamalari yoki kurslar o‘zgarganda u o‘zgaradi. Narxlarni saqlasangiz — versiya o‘zgarganda qayta hisoblang. unverified > 0 — ayrim stavkalar hali tekshirilmagan, hisob dastlabki.

Xatolar

401

Kalit yo‘q yoki bekor qilingan.

404

Katalogda bunday lotId’li mashina yo‘q.

422

Mashina ma’lumotlarida xato (fields’da qaysi maydonlar) yoki noma’lum mamlakat.

429

Daqiqalik yoki sutkalik limit oshdi.

500

Bizning tomonda xato — u allaqachon jurnalda.

Saytingiz uchun vidjet

Menejerga ariza bilan kalit topshirish kalkulyatori — bitta qatorda. «CORE8 GLOBAL» imzosi va bizning dizayn, mijozning standart mamlakati — data-country’dan.

<script src="https://core8global.com/widget.js" data-partner="your-slug" data-country="KZ" async></script>

Vidjetdan arizalar CRM’imizga hamkor belgisi bilan keladi — siz nechta mijoz olib kelganingiz ko‘rinadi.