← Voor bedrijven

API voor bedrijven

De API is bedoeld voor bedrijven die advertenties vanuit hun eigen systeem willen beheren. Advertenties gedragen zich hetzelfde als via een feed geïmporteerde — dezelfde velden en regels.

Sleutel

U maakt de API-sleutel aan in uw bedrijfsaccount (Account → Bedrijfsprofiel → API en import). De sleutel wordt één keer getoond; u kunt hem op elk moment intrekken of een nieuwe aanmaken. Publiceren via de API is mogelijk zodra het bedrijf is goedgekeurd.

Authorization: Bearer as_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Verzoeken

{id} — de ID van de advertentie in uw systeem (letters, cijfers, punt, koppelteken, underscore, dubbele punt; maximaal 120 tekens). De advertentie wordt op basis van deze ID bijgewerkt, dus die moet gelijk blijven.

Voorbeeld

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

Antwoord: 201 — aangemaakt, 200 — bijgewerkt of ongewijzigd.

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

Verwijderen: DELETE /api/v1/listings/A-1042?reason=sold

Velden

Alleen “price” is verplicht (groter dan 0). De categorie is onze categorie-slug (bijv. automobiliai, motociklai-visi, sunkvezimiai-visi, automobiliu-dalys); merk en model als gewone namen (worden automatisch herkend).

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

Foto's — een array met openbare afbeeldings-URL's (maximaal 30); ze worden binnen enkele minuten op de achtergrond gedownload. Als de lijst verandert, worden de foto's bijgewerkt.

Feed voor automatische import

Dezelfde velden werken in een XML-, CSV- of JSON-feed waarvan u het adres in uw bedrijfsaccount opgeeft. De feed wordt regelmatig gecontroleerd; advertenties die langer dan 3 dagen in de feed ontbreken, worden verborgen.

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

Limieten en fouten

Maximaal 600 verzoeken per minuut per sleutel. Fouten worden als JSON teruggegeven met de velden “error” en “message”.