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

• Суммы — целыми числами в минимальных единицах валюты страны (тиыны, копейки) + готовая строка totalText на языке locale.
• Если данных не хватает (например, мощности для РФ), 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 с меткой партнёра — видно, сколько клиентов привели вы.