Veřejné API aut

Vytvoření klíče

1. Přihlaste se do autolink jako vlastník organizace a otevřete Propojení.
2. V části Web / API klikněte na Vytvořit API klíč a pojmenujte ho, například „Firemní web“.
3. Zkopírujte klíč a uložte ho na svém serveru. Zobrazí se jen jednou.

Klíče začínají alk_live_. Organizace může mít až 10 aktivních klíčů a kterýkoli můžete kdykoli zrušit na stejné stránce. Zrušený klíč přestane fungovat při dalším požadavku.

Která auta se vracejí

Auto se vrátí, jen když platí obojí:

1. Stav auta je Skladem nebo Rezervováno.
2. Jeho zveřejnění na Interní web má stav Aktivní.

Aktivní zveřejnění na jiném portálu auto v API nikdy neobjeví.

Jak auto zveřejnit

1. V autolink otevřete Inzeráty.
2. Najděte auto. Ve sloupci Interní web klikněte na Publikovat (nebo Obnovit, pokud je Pozastaveno).
3. Stav se změní na Aktivní a auto se v API objeví při dalším požadavku.

Chcete-li auto z webu stáhnout, otevřete v téže buňce nabídku stavu a zvolte Pozastavit nebo Odstranit, případně označte auto jako Prodáno nebo Archivováno. Zmizí při dalším požadavku.

Ověření

Klíč posílejte v hlavičce Authorization:

Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Klíč v adrese URL (?key=...) se odmítne. API volejte z vašeho serveru, nikdy z kódu v prohlížeči.

Seznam aut

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();

Odpověď:

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

Auta jsou seřazena podle updated_at, nejnovější první. Když je next_cursor rovno null, další stránky nejsou.

Jedno auto

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

Vrátí { "data": { ...auto } }. Auto, které neexistuje, patří jiné organizaci nebo není zveřejněné, vrátí 404.

Pole

Chyby

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

Limity

Každý klíč může zadat zhruba 120 požadavků za minutu. Adresa, která opakovaně posílá špatné klíče, dostává na minutu 429 ještě před ověřením klíče. Odpovědi se nekešují (Cache-Control: private, no-store): pokud má váš web hodně návštěv, kešujte je u sebe. CORS je záměrně vypnuté, protože klíč musí zůstat na vašem serveru.

Bezpečnost

• Klíč uchovávejte v prostředí svého serveru, ne v kódu prohlížeče, mobilních aplikací ani ve veřejném repozitáři.
• Pro každý web nebo službu používejte jeden klíč, abyste mohli zrušit jeden a nedotknout se ostatních.
• Pokud klíč mohl uniknout, zrušte ho na stránce Propojení a vytvořte nový.