REST JSON VIN i SPZ

Prověřování vozidel přímo ve vašem systému

Napojte vyhledávání podle VIN nebo SPZ přes jednoduché HTTP API. Odpověď vrací strukturovaná data o vozidle, technických údajích, historii záznamů, STK/SME, nájezdech, pojištění a dalších dostupných informacích.

API je dostupné od tarifu Profi výše.

POST /api/v1/search Bearer token
{
  "query": "TMBXXX12X34567890",
  "include": ["theft", "vignette"]
}
HTTP/1.1 200 OK
{
  "vehicle": {
    "brand": "ŠKODA",
    "model": "OCTAVIA III",
    …
  }
}

Co API umí

Jedno hlavní vyhledávání, stejná logika jako web, výstup připravený pro další zpracování.

Vyhledání podle VIN nebo SPZ

SPZ se interně převede na VIN. SPZ zpětně z VIN nevracíme.

Technická data vozidla

Značka, model, kategorie, motor, rozměry, hmotnosti, emise, pneumatiky a další dostupné údaje.

Historie a záznamy

STK/SME, nájezdy, dovoz, vyřazení, dostupné změny a další evidované záznamy.

Volitelné kontroly

Kontrola odcizení a dálniční známky přes parametr include nebo full.

Napojení za pár minut

Žádné schvalování ani smlouvy předem. Tarif, klíč, request.

1

Aktivujete tarif s API

API přístup je součástí tarifů Profi, Business a Enterprise.

2

Vygenerujete API klíč

Klíč najdete po přihlášení v sekci Můj tarif.

3

Voláte endpoint

Dotaz posíláte jako JSON na /api/v1/search s hlavičkou Authorization: Bearer.

Vyhledávání podle SPZ

API umí přijmout VIN i registrační značku. U SPZ probíhá interní převod na VIN, se kterým se dál pracuje v odpovědi.

~51 %

aktuálně provozovaných vozidel v naší databázi má dohledatelnou SPZ

Pokud SPZ nenajdeme, je možné dotaz opakovat přímo přes VIN.

Limity a očekávání

10/min

Profi

20/min

Business

60/min

Enterprise

  • Denní limit hledání se řídí tarifem a sdílí se s webovým vyhledáváním.
  • Některé volitelné kontroly volají externí zdroje a mohou odpověď prodloužit.
  • Vracíme dostupná data, ne garantovaný kompletní životopis každého vozidla.

Autokuk API

Chcete API napojit?

Vyberte tarif s API přístupem, vygenerujte klíč a pokračujte podle dokumentace endpointů.