Verejné API áut

Vytvorenie kľúča

1. Prihláste sa do autolink ako vlastník organizácie a otvorte Prepojenia.
2. V časti Web / API kliknite na Vytvoriť API kľúč a pomenujte ho, napríklad „Firemný web“.
3. Skopírujte kľúč a uložte ho na svojom serveri. Zobrazí sa len raz.

Kľúče začínajú alk_live_. Organizácia môže mať až 10 aktívnych kľúčov a ktorýkoľvek môžete kedykoľvek zrušiť na tej istej stránke. Zrušený kľúč prestane fungovať pri ďalšej požiadavke.

Ktoré autá sa vracajú

Auto sa vráti, len ak platí oboje:

1. Stav auta je Skladom alebo Rezervované.
2. Jeho zverejnenie na Interný web má stav Aktívne.

Aktívne zverejnenie na inom portáli auto v API nikdy neobjaví.

Ako auto zverejniť

1. V autolink otvorte Inzeráty.
2. Nájdite auto. V stĺpci Interný web kliknite na Publikovať (alebo Obnoviť, ak je Pozastavené).
3. Stav sa zmení na Aktívne a auto sa v API objaví pri ďalšej požiadavke.

Ak chcete auto z webu stiahnuť, otvorte v tej istej bunke ponuku stavu a zvoľte Pozastaviť alebo Odstrániť, prípadne označte auto ako Predané alebo Archivované. Zmizne pri ďalšej požiadavke.

Overenie

Kľúč posielajte v hlavičke Authorization:

Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Kľúč v adrese URL (?key=...) sa odmietne. API volajte z vášho servera, nikdy z kódu v prehliadači.

Zoznam áut

GET https://www.autolink.sk/api/public/v1/cars

curl "https://www.autolink.sk/api/public/v1/cars?limit=20" \
  -H "Authorization: Bearer $AUTOLINK_API_KEY"

const response = await fetch('https://www.autolink.sk/api/public/v1/cars?limit=20', {
  headers: { Authorization: `Bearer ${process.env.AUTOLINK_API_KEY}` },
});

const { data, next_cursor } = await response.json();

Odpoveď:

{
  "data": [
    {
      "id": "0b6c3a52-6f3e-4a35-9d3e-2a6f0f3b1c10",
      "brand": "Skoda",
      "model": "Octavia",
      "variant": "2.0 TDI Style",
      "year": 2021,
      "first_registration": "2021-03-15",
      "mileage_km": 64200,
      "power_kw": 110,
      "engine_l": 2.0,
      "engine_ccm": 1968,
      "fuel": "diesel",
      "transmission": "automatic",
      "body": "combi",
      "color": "grey",
      "color_name": "Moon white",
      "emission": "EU6d",
      "drive": "fwd",
      "doors": 5,
      "seats": 5,
      "equipment": [],
      "asking_price": 18900,
      "currency": "EUR",
      "status": "in_stock",
      "description": "First owner, service history.",
      "photos": [],
      "updated_at": "2026-10-20T09:15:00.123456+00:00"
    }
  ],
  "next_cursor": "WyIyMDI2LTEwLTIwVDA5OjE1OjAwLjEyMzQ1NiswMDowMCIsIjBiNmMzYTUyLTZmM2UtNGEzNS05ZDNlLTJhNmYwZjNiMWMxMCJd"
}

Autá sú zoradené podľa updated_at, najnovšie prvé. Keď je next_cursor rovné null, ďalšie stránky nie sú.

Jedno auto

GET https://www.autolink.sk/api/public/v1/cars/{id}

Vráti { "data": { ...auto } }. Auto, ktoré neexistuje, patrí inej organizácii alebo nie je zverejnené, vráti 404.

Polia

Chyby

Chyby sú JSON: { "error": "<kód>" }.

Limity

Každý kľúč môže zadať približne 120 požiadaviek za minútu. Adresa, ktorá opakovane posiela nesprávne kľúče, dostáva na minútu 429 ešte pred overením kľúča. Odpovede sa nekešujú (Cache-Control: private, no-store): ak má váš web veľa návštev, kešujte ich u seba. CORS je zámerne vypnuté, pretože kľúč musí zostať na vašom serveri.

Bezpečnosť

• Kľúč uchovávajte v prostredí svojho servera, nie v kóde prehliadača, mobilných aplikáciách ani vo verejnom repozitári.
• Pre každý web alebo službu používajte jeden kľúč, aby ste mohli zrušiť jeden a nedotknúť sa ostatných.
• Ak kľúč mohol uniknúť, zrušte ho na stránke Prepojenia a vytvorte nový.