← Pro firmy

API pro firmy

API je určeno firmám, které chtějí spravovat inzeráty ze svého systému. Inzeráty se chovají stejně jako importované z feedu — stejná pole i pravidla.

Klíč

API klíč si vytvoříte ve firemním účtu (Účet → Profil firmy → API a import). Klíč se zobrazí jednou; kdykoli jej můžete zrušit nebo vytvořit nový. Publikovat přes API lze, jakmile je firma schválena.

Authorization: Bearer as_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Požadavky

{id} — ID inzerátu ve vašem systému (písmena, číslice, tečka, pomlčka, podtržítko, dvojtečka; až 120 znaků). Podle něj se inzerát aktualizuje, proto musí zůstat stejné.

Příklad

curl -X PUT https://autoskelbimai.com/api/v1/listings/A-1042 \
  -H "Authorization: Bearer as_xxxxxxxx…" -H "Content-Type: application/json" \
  -d '{
    "category": "automobiliai", "make": "Volkswagen", "model": "Golf", "version": "1.4 TSI Highline",
    "year": 2017, "mileage": 98000, "price": 12900, "currency": "EUR",
    "fuel": "petrol", "gearbox": "manual", "body": "hatchback", "power_kw": 92,
    "vin": "WVWZZZAUZHW000000", "city": "Vilnius", "country": "LT",
    "description": "…", "description_lang": "lt",
    "photos": ["https://example.com/foto/1.jpg", "https://example.com/foto/2.jpg"]
  }'

Odpověď: 201 — vytvořeno, 200 — aktualizováno nebo beze změny.

{"result": "created", "id": 2381, "external_id": "A-1042", "status": "active", "url": "https://autoskelbimai.com/skelbimas/2381-volkswagen-golf-1-4-tsi-highline", …}

Odstranění: DELETE /api/v1/listings/A-1042?reason=sold

Pole

Povinné je pouze „price“ (větší než 0). Kategorie je adresa naší kategorie (např. automobiliai, motociklai-visi, sunkvezimiai-visi, automobiliu-dalys); značka a model běžnými názvy (rozpoznají se automaticky).

id url category deal make model version title year month mileage hours price currency fuel gearbox body drive power_kw power_hp engine_cc color doors seats vin condition country city description description_lang negotiable vat phone photos fuel_city fuel_highway fuel_combined co2

Fotografie — pole veřejných adres obrázků (až 30); stahují se na pozadí během několika minut. Při změně seznamu se fotografie aktualizují.

Feed pro automatický import

Stejná pole fungují ve feedu XML, CSV nebo JSON, jehož adresu zadáte ve firemním účtu. Feed se pravidelně kontroluje; inzeráty, které ve feedu chybí déle než 3 dny, se skryjí.

<listings>
  <listing>
    <id>A-1042</id><category>automobiliai</category><make>Volkswagen</make><model>Golf</model>
    <year>2017</year><mileage>98000</mileage><price>12900</price><currency>EUR</currency>
    <photos><photo>https://example.com/foto/1.jpg</photo></photos>
  </listing>
</listings>

Limity a chyby

Až 600 požadavků za minutu na jeden klíč. Chyby se vracejí ve formátu JSON s poli „error“ a „message“.