← For virksomheder

Virksomheds-API

API'et er til virksomheder, der vil administrere annoncer fra deres eget system. Annoncerne fungerer på samme måde som dem, der importeres fra et feed — samme felter og regler.

Nøgle

Du opretter API-nøglen i din virksomhedskonto (Konto → Virksomhedsprofil → API og import). Nøglen vises én gang; du kan når som helst tilbagekalde den eller oprette en ny. Udgivelse via API'et er mulig, når virksomheden er godkendt.

Authorization: Bearer as_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Forespørgsler

{id} — annoncens ID i dit system (bogstaver, cifre, punktum, bindestreg, understregning, kolon; op til 120 tegn). Annoncen opdateres ud fra dette ID, så det skal forblive det samme.

Eksempel

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

Svar: 201 — oprettet, 200 — opdateret eller uændret.

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

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

Felter

Kun »price« er påkrævet (større end 0). Kategorien er vores kategori-slug (f.eks. automobiliai, motociklai-visi, sunkvezimiai-visi, automobiliu-dalys); mærke og model angives med almindelige navne (genkendes automatisk).

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

Billeder — et array af offentlige billed-URL'er (op til 30); de downloades i baggrunden inden for få minutter. Når listen ændres, opdateres billederne.

Feed til automatisk import

De samme felter virker i et XML-, CSV- eller JSON-feed, hvis adresse du angiver i din virksomhedskonto. Feedet kontrolleres regelmæssigt; annoncer, der har manglet i feedet i mere end 3 dage, skjules.

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

Grænser og fejl

Op til 600 forespørgsler pr. minut pr. nøgle. Fejl returneres som JSON med felterne »error« og »message«.