Серіктестерге арналған API және виджет

Кілт және лимиттер

Әр сұрау Authorization: Bearer vk_live_… тақырыбындағы кілтпен. Кілт бізде тек хеш түрінде сақталады: жоғалтсаңыз — жаңасын береміз.

• Әр кілттің минуттық және тәуліктік лимиттері бар. Қалдық — X-RateLimit-Remaining және X-RateLimit-Day-Remaining тақырыптарында; асып кетсе — 429 жауабы және Retry-After.
• Әр сұрау журналға жазылады: жауап уақыты, мәртебе, ел, тарифтер нұсқасы.
• Кілтті менеджер береді — бізге жазыңыз

Кілтпен тапсыру бағасы: POST /api/v1/quote

Көлік деректерін (марка, жыл, сатушы бағасы вонмен немесе юаньмен, көлем, қуат, отын) және клиент елін жіберіңіз; қала — міндетті емес.

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"}}'

Жауап:

{
  "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 }
}

• Сомалар — ел валютасының ең кіші бірліктеріндегі бүтін сандар + locale тіліндегі дайын totalText жолы.
• Деректер жетпесе (мысалы, РФ үшін қуат), quote.ok = false, ал quote.missing ішінде не қажет екені.
• car орнына lotId — біздің каталогтағы көлік нөмірін жіберуге болады.

Тарифтер нұсқасы

Әр жауапта және X-Tariff-Version тақырыбында ел тарифтерінің нұсқасы бар. Кеден мөлшерлемелері, ел баптаулары немесе бағамдар өзгергенде ол өзгереді. Бағаларды сақтасаңыз — нұсқа өзгергенде қайта есептеңіз. unverified > 0 — кейбір мөлшерлемелер әлі тексерілмеген, есеп алдын ала.

Қателер

401

Кілт жоқ немесе кері қайтарылған.

404

Каталогта мұндай lotId бар көлік жоқ.

422

Көлік деректерінде қате (fields ішінде қай өрістер) немесе белгісіз ел.

429

Минуттық немесе тәуліктік лимит асты.

500

Біз жақтағы қате — ол журналда.

Сайтыңызға виджет

Менеджерге өтініммен кілтпен тапсыру калькуляторы — бір жолмен. «CORE8 GLOBAL» белгісі және біздің дизайн, клиенттің әдепкі елі — data-country ішінен.

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

Виджеттен өтінімдер біздің CRM-ге серіктес белгісімен келеді — сіз қанша клиент әкелгеніңіз көрінеді.