← Pre firmy

API pre firmy

API je určené firmám, ktoré chcú spravovať inzeráty zo svojho systému. Inzeráty sa správajú rovnako ako importované z feedu — rovnaké polia aj pravidlá.

Kľúč

API kľúč si vytvoríte vo firemnom účte (Účet → Profil firmy → API a import). Kľúč sa zobrazí raz; kedykoľvek ho môžete zrušiť alebo vytvoriť nový. Publikovať cez API je možné, keď je firma schválená.

Authorization: Bearer as_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Požiadavky

{id} — ID inzerátu vo vašom systéme (písmená, číslice, bodka, pomlčka, podčiarkovník, dvojbodka; najviac 120 znakov). Podľa neho sa inzerát aktualizuje, preto musí zostať rovnaké.

Prí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"]
  }'

Odpoveď: 201 — vytvorené, 200 — aktualizované alebo bez zmeny.

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

Odstránenie: DELETE /api/v1/listings/A-1042?reason=sold

Polia

Povinné je iba „price“ (väčšie ako 0). Kategória je adresa našej kategórie (napr. automobiliai, motociklai-visi, sunkvezimiai-visi, automobiliu-dalys); značka a model bežnými názvami (rozpoznajú sa 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 verejných adries obrázkov (najviac 30); sťahujú sa na pozadí v priebehu niekoľkých minút. Pri zmene zoznamu sa fotografie aktualizujú.

Feed pre automatický import

Rovnaké polia fungujú vo feede XML, CSV alebo JSON, ktorého adresu zadáte vo firemnom účte. Feed sa pravidelne kontroluje; inzeráty, ktoré vo feede chýbajú dlhšie ako 3 dni, sa 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

Najviac 600 požiadaviek za minútu na jeden kľúč. Chyby sa vracajú vo formáte JSON s poliami „error“ a „message“.