← Uzņēmumiem

Uzņēmumu API

API ir paredzēta uzņēmumiem, kas vēlas pārvaldīt sludinājumus no savas sistēmas. Sludinājumi darbojas tāpat kā no plūsmas importētie — tie paši lauki un noteikumi.

Atslēga

API atslēgu izveidojiet uzņēmuma kontā (Konts → Uzņēmuma profils → API un imports). Atslēga tiek parādīta vienu reizi; jebkurā laikā varat to atsaukt vai izveidot jaunu. Publicēt caur API var, kad uzņēmums ir apstiprināts.

Authorization: Bearer as_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Pieprasījumi

{id} — sludinājuma ID jūsu sistēmā (burti, cipari, punkts, defise, pasvītra, kols; līdz 120 rakstzīmēm). Pēc tā sludinājums tiek atjaunināts, tāpēc tam jāpaliek nemainīgam.

Piemērs

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

Atbilde: 201 — izveidots, 200 — atjaunināts vai nemainīts.

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

Dzēšana: DELETE /api/v1/listings/A-1042?reason=sold

Lauki

Obligāts ir tikai “price” (lielāks par 0). Kategorija — mūsu kategorijas adrese (piem., automobiliai, motociklai-visi, sunkvezimiai-visi, automobiliu-dalys); marka un modelis — ierastajos nosaukumos (tiek atpazīti automātiski).

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

Fotoattēli — publisku attēlu adrešu masīvs (līdz 30); tiek lejupielādēti fonā dažu minūšu laikā. Mainot sarakstu, fotoattēli tiek atjaunināti.

Automātiskā importa plūsma

Tie paši lauki der XML, CSV vai JSON plūsmā, kuras adresi norādāt uzņēmuma kontā. Plūsma tiek pārbaudīta regulāri; sludinājumi, kuru plūsmā nav ilgāk par 3 dienām, tiek paslēpti.

<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>

Ierobežojumi un kļūdas

Līdz 600 pieprasījumiem minūtē uz vienu atslēgu. Kļūdas tiek atgrieztas JSON formātā ar laukiem “error” un “message”.