Hooga

Edasimüüjatele ja nende IT-partneritele

Laoseisu fail

Avalda müügis olevad autod ühe XML- või JSON-failina https-aadressil. Hooga loeb seda iga tund ja hoiab kuulutused failiga kooskõlas. Kuulutamine ja import on mõlemad tasuta.

Kuidas see käib

  1. 01

    Avalda fail

    Sinu laosüsteem kirjutab kõik müügis olevad autod ühte XML- või JSON-faili, mis asub https-aadressil.

  2. 02

    Lisa faili aadress

    Edasimüüja profiili omanik lisab aadressi vahekaardil "Autode import". Loeme faili kohe ja näitame, mida sealt leidsime: autod ja märkused. Avaldatud ei ole veel midagi.

  3. 03

    Alusta importi

    Sealtpeale loeme faili iga tund: uued autod ilmuvad, muutunud autod uuendatakse ja failist kadunud autod võetakse maha.

Saadad laoseisu juba mõnda teise portaali?

Saada see fail või selle aadress aadressile [email protected]. Kui failis on kõik, mida autokuulutus vajab, lisame selle vormingu ja sinu poolel ei pea midagi muutma.

Faili ülesehitus

Iga auto kohta üks kirje. Väljade nimed ja väärtused on mõlemas vormingus samad ning vormingu tunneme ise ära. Fail on UTF-8 kodeeringus.

  • JSON: objekt, milles on loend "cars" (sobib ka lihtsalt autode loend). {"cars": [{ ... }, { ... }]}
  • XML: juurelement "cars", iga auto kohta üks element "car". <cars><car> ... </car></cars>

XML-is korratakse pealkirja ja kirjeldust iga keele kohta atribuudiga lang, varustus on elementide "item" loend ja fotod elementide "photo" loend. Kõike seda näitab allolev näide.

Ühe auto väljad

Kohustuslikud on täpselt need väljad, mida küsib enne avaldamist ka auto müügivorm. Auto, millel mõni neist puudub, jäetakse vahele ja nimetatakse logis. Ülejäänud fail imporditakse.

Väli Kohustuslik Mida sinna kirjutada
external_id jah Sinu enda tunnus auto jaoks, kuni 191 märki. See peab jääma samaks nii kaua, kui auto failis on: selle järgi tunneme auto ära.
status ei live (vaikimisi), paused või sold. Vaata allpool reegleid.
make jah Mark nii, nagu see on meie loendis: "Volkswagen", "Škoda", "Mercedes-Benz". Mõistame ka kirjapilte "VW", "Skoda" ja "Mercedes". Auto, mille marki meie loendis pole, jäetakse vahele: kirjuta meile ja lisame margi.
model jah Mudel: "Golf". Kui see on meie loendis, kirjutame selle oma kirjapildis, muidu jääb nii, nagu sina kirjutasid.
variant ei Mootor ja varustustase nii, nagu neid nimetaksid: "1.5 TSI Style". Kuni 80 märki.
year jah Esmase registreerimise aasta.
month ei Esmase registreerimise kuu, 1 kuni 12. Aasta ja kuu asemel võid saata välja first_registration, näiteks "2019-03".
mileage_km jah Läbisõidumõõdiku näit kilomeetrites.
price jah Hind, mille ostja maksab, täiseurodes.
vat_deductible ei true, kui hind sisaldab käibemaksu ja ostja saab käibemaksuga arve. Kui väli puudub, siis false.
fuel jah Üks allpool loetletud väärtustest.
gearbox jah manual või automatic.
drive ei front, rear või awd.
body ei Üks allpool loetletud väärtustest.
power_kw ei Mootori võimsus kilovattides. Hobujõududes väärtus ("150 hj") arvutatakse ümber.
engine_cc ei Mootori töömaht kuupsentimeetrites. "1.5" loetakse liitriteks.
color ei Üks allpool loetletud väärtustest. Pikem värvinimi ("Tumehall metallik") viiakse kokku lähimaga.
doors ei 2 kuni 6.
seats ei 1 kuni 9.
owners ei Mitu omanikku autol on olnud.
condition ei Üks allpool loetletud väärtustest.
service_history ei Üks allpool loetletud väärtustest.
inspection_until ei Kuu, milleni tehnoülevaatus kehtib: "2027-03".
imported_from ei Selle riigi kahetäheline kood, kust auto toodi. Jäta välja, kui auto müüdi uuena Eestis.
vin ei VIN-koodi 17 märki. Hoitakse kuulutuse juures, avalikult ei näidata kunagi.
plate ei Numbrimärk. Hoitakse kuulutuse juures, avalikult ei näidata kunagi.
equipment ei Loend allpool toodud väärtustest. Mida loendis pole, see käib kirjeldusse.
county ei Üks 15 maakonnast, kirjutatuna nagu allpool. Mõistame ka kirjapilti "Harjumaa".
city jah Linn või vald, kus autot näha saab, eesti keeles: "Tallinn".
headline jah Üks rida keele kohta (et, ru, en), kuni 80 märki.
description jah Tekst keele kohta (et, ru, en), kuni 3 000 märki. HTML muudetakse lihttekstiks. Vähemalt ühes keeles peab olema nii pealkiri kui ka kirjeldus.
photos jah Fotode https-aadressid selles järjekorras, nagu neid näidatakse. Esimene on kaanefoto. Vähemalt üks, kõige rohkem 50.
video_url ei YouTube'i link.
agent_email ei Selle müügimeeskonna liikme sisselogimise e-post, kes autot müüb: kuulutusel on tema nimi ja sõnumid jõuavad tema postkasti. Kui väli puudub või e-post ei kuulu teie meeskonda, läheb auto profiili omaniku nimele.
updated_at ei Millal autot viimati muutsid. Vabatahtlik ja seda ei kasutata: võrdleme sisu ennast.

Lubatud väärtused

Saada väärtused täpselt nii, nagu need on kirjas.

status
live paused sold
fuel
petrol diesel hybrid plugin_hybrid electric gas
gearbox
manual automatic
drive
front rear awd
body
hatchback sedan estate suv coupe convertible minivan pickup van
color
white black grey silver blue red green brown beige yellow orange other
condition
excellent good fair needs_work
service_history
full_dealer full_independent partial none
equipment
led_headlights adaptive_cruise cruise_control heated_seats heated_steering_wheel carplay navigation parking_sensors parking_camera tow_bar sunroof leather keyless digital_cockpit climate_control parking_heater winter_tyres roof_rails
imported_from
DE SE FI LV LT PL NL BE FR IT ES AT CH DK NO GB US JP KR
county
Harju maakond Hiiu maakond Ida-Viru maakond Jõgeva maakond Järva maakond Lääne maakond Lääne-Viru maakond Põlva maakond Pärnu maakond Rapla maakond Saare maakond Tartu maakond Valga maakond Viljandi maakond Võru maakond

Loeme ka muid tavalisi kirjapilte: suurtähti, eesti-, vene- ja ingliskeelseid sõnu ("Automaat", "diisel", "универсал") ning arve tühikute või ühikutega ("84 200 km", "110 kW"). Vabatahtlik väärtus, millest me aru ei saa, jäetakse välja ja märgitakse logisse. Auto jääb vahele ainult kohustusliku välja pärast.

Reeglid ja piirangud

  • Faili loetakse kord tunnis. Ebaõnnestunud lugemine ei muuda midagi. Seejärel ootame enne uut katset kauem (1 h, 3 h, 12 h, 24 h) ja pärast 3 järjestikust ebaõnnestumist saab profiili omanik ühe e-kirja.
  • Midagi ei avaldata enne, kui edasimüüja profiili omanik on eelvaadet näinud ja vajutanud "Alusta importi".
  • Autod viiakse kokku välja external_id järgi. Autot, mille kirje ei muutunud, ei puudutata. Portaalis käsitsi lisatud autodel external_id puudub ja import neid ei puuduta.
  • Auto, mis puudub 2 järjestikusest õnnestunud lugemisest, võetakse portaalist maha. Kui see on failis tagasi, ilmub see uuesti samal lehel.
  • Uus hind läheb auto hinnaajalukku samamoodi nagu käsitsi muudetud hind.
  • Olek "paused" jätab auto sinu kontole, kuid võtab selle portaalist maha, "sold" märgib auto müüduks. Failis muutunud olekut järgitakse üks kord: mida pärast seda portaalis käsitsi muudad, jääb kehtima, kuni fail ütleb midagi uut.
  • Fotod: kuni 50 auto kohta, ainult https, JPEG, PNG või WebP, igaüks kuni 25 MB. Laadime iga foto alla ühe korra ja hoiame oma koopiat ilma asukoha- ja kaameraandmeteta. Ebaõnnestunud fotot proovime järgmisel lugemisel uuesti ning auto avaldatakse siis, kui vähemalt üks foto on kohal.
  • Fail: kuni 20 MB ja 5 000 autot, vastus 20 sekundi jooksul avalikul https-aadressil, kõige rohkem 3 ümbersuunamist. Sisselogimist ei ole: kui aadress peab jääma privaatseks, pane sellesse pikk juhuslik osa.
  • Edasimüüjal võib olla kuni 5 faili. Faili saab ka üks kord käsitsi üles laadida: nii imporditakse selle autod ja ühtegi maha ei võeta.
  • Failis olevat ei kontrollita ühegi välise allika järgi ja sellele ei lisata midagi: auto lehel on kirjas see, mida sa saatsid.

Kiiremini kui kord tunnis

Süsteem, mis teab, millal auto muutub, saab selle ühe auto kohe kuulutuste API kaudu ära saata: samad väljad, üks auto päringu kohta. Juurdepääs lülitatakse edasimüüjale sisse taotluse alusel.

Kuulutuste API

Täielik näide

Kolm autot: esimesel on kõik väljad, viimasel ainult kohustuslikud. Mõlemas failis on samad autod.

hooga-feed-example.xml Laadi alla
<?xml version="1.0" encoding="UTF-8"?>
<cars>
  <car>
    <external_id>A-1041</external_id>
    <status>live</status>
    <make>Volkswagen</make>
    <model>Golf</model>
    <variant>1.5 TSI Style</variant>
    <year>2019</year>
    <month>3</month>
    <mileage_km>84200</mileage_km>
    <price>16900</price>
    <vat_deductible>true</vat_deductible>
    <fuel>petrol</fuel>
    <gearbox>automatic</gearbox>
    <drive>front</drive>
    <body>hatchback</body>
    <power_kw>110</power_kw>
    <engine_cc>1498</engine_cc>
    <color>grey</color>
    <doors>5</doors>
    <seats>5</seats>
    <owners>1</owners>
    <condition>good</condition>
    <service_history>full_dealer</service_history>
    <inspection_until>2027-03</inspection_until>
    <imported_from>DE</imported_from>
    <vin>WVWZZZCDZKW123456</vin>
    <plate>123 ABC</plate>
    <equipment>
      <item>led_headlights</item>
      <item>adaptive_cruise</item>
      <item>heated_seats</item>
      <item>carplay</item>
      <item>parking_camera</item>
      <item>climate_control</item>
      <item>winter_tyres</item>
    </equipment>
    <county>Harju maakond</county>
    <city>Tallinn</city>
    <headline lang="et">Üks omanik, täielik hooldusajalugu</headline>
    <headline lang="ru">Один владелец, полная история обслуживания</headline>
    <headline lang="en">One owner, full service history</headline>
    <description lang="et">Ostetud uuena Saksamaalt, hooldatud esinduses.
Kaasa suverehvid valuvelgedel.</description>
    <description lang="ru">Куплен новым в Германии, обслуживался у официального дилера.
В комплекте летние шины на литых дисках.</description>
    <description lang="en">Bought new in Germany and serviced at the main dealer.
Summer tyres on alloy wheels are included.</description>
    <photos>
      <photo>https://media.example.ee/stock/A-1041/1.jpg</photo>
      <photo>https://media.example.ee/stock/A-1041/2.jpg</photo>
      <photo>https://media.example.ee/stock/A-1041/3.jpg</photo>
    </photos>
    <video_url>https://www.youtube.com/watch?v=aqz-KE-bpKQ</video_url>
    <agent_email>[email protected]</agent_email>
    <updated_at>2026-11-18T09:30:00+02:00</updated_at>
  </car>
  <car>
    <external_id>A-1057</external_id>
    <make>Toyota</make>
    <model>RAV4</model>
    <variant>2.5 Hybrid</variant>
    <year>2021</year>
    <month>5</month>
    <mileage_km>61500</mileage_km>
    <price>29400</price>
    <fuel>hybrid</fuel>
    <gearbox>automatic</gearbox>
    <drive>awd</drive>
    <body>suv</body>
    <power_kw>160</power_kw>
    <color>white</color>
    <owners>1</owners>
    <equipment>
      <item>navigation</item>
      <item>tow_bar</item>
      <item>keyless</item>
    </equipment>
    <county>Tartu maakond</county>
    <city>Tartu</city>
    <headline lang="et">Nelikvedu ja veokonks</headline>
    <description lang="et">Müüa heas korras linnamaastur. Hooldusraamat on kaasas.</description>
    <photos>
      <photo>https://media.example.ee/stock/A-1057/1.jpg</photo>
      <photo>https://media.example.ee/stock/A-1057/2.jpg</photo>
    </photos>
  </car>
  <car>
    <external_id>A-1063</external_id>
    <make>Škoda</make>
    <model>Octavia</model>
    <year>2017</year>
    <mileage_km>148000</mileage_km>
    <price>9800</price>
    <fuel>diesel</fuel>
    <gearbox>manual</gearbox>
    <city>Pärnu</city>
    <headline lang="et">Ökonoomne universaal</headline>
    <headline lang="en">An economical estate</headline>
    <description lang="et">Korralik pereauto.</description>
    <description lang="en">A tidy family car.</description>
    <photos>
      <photo>https://media.example.ee/stock/A-1063/1.jpg</photo>
    </photos>
  </car>
</cars>
hooga-feed-example.json Laadi alla
{
    "cars": [
        {
            "external_id": "A-1041",
            "status": "live",
            "make": "Volkswagen",
            "model": "Golf",
            "variant": "1.5 TSI Style",
            "year": 2019,
            "month": 3,
            "mileage_km": 84200,
            "price": 16900,
            "vat_deductible": true,
            "fuel": "petrol",
            "gearbox": "automatic",
            "drive": "front",
            "body": "hatchback",
            "power_kw": 110,
            "engine_cc": 1498,
            "color": "grey",
            "doors": 5,
            "seats": 5,
            "owners": 1,
            "condition": "good",
            "service_history": "full_dealer",
            "inspection_until": "2027-03",
            "imported_from": "DE",
            "vin": "WVWZZZCDZKW123456",
            "plate": "123 ABC",
            "equipment": [
                "led_headlights",
                "adaptive_cruise",
                "heated_seats",
                "carplay",
                "parking_camera",
                "climate_control",
                "winter_tyres"
            ],
            "county": "Harju maakond",
            "city": "Tallinn",
            "headline": {
                "et": "Üks omanik, täielik hooldusajalugu",
                "ru": "Один владелец, полная история обслуживания",
                "en": "One owner, full service history"
            },
            "description": {
                "et": "Ostetud uuena Saksamaalt, hooldatud esinduses.\nKaasa suverehvid valuvelgedel.",
                "ru": "Куплен новым в Германии, обслуживался у официального дилера.\nВ комплекте летние шины на литых дисках.",
                "en": "Bought new in Germany and serviced at the main dealer.\nSummer tyres on alloy wheels are included."
            },
            "photos": [
                "https://media.example.ee/stock/A-1041/1.jpg",
                "https://media.example.ee/stock/A-1041/2.jpg",
                "https://media.example.ee/stock/A-1041/3.jpg"
            ],
            "video_url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ",
            "agent_email": "[email protected]",
            "updated_at": "2026-11-18T09:30:00+02:00"
        },
        {
            "external_id": "A-1057",
            "make": "Toyota",
            "model": "RAV4",
            "variant": "2.5 Hybrid",
            "year": 2021,
            "month": 5,
            "mileage_km": 61500,
            "price": 29400,
            "fuel": "hybrid",
            "gearbox": "automatic",
            "drive": "awd",
            "body": "suv",
            "power_kw": 160,
            "color": "white",
            "owners": 1,
            "equipment": [
                "navigation",
                "tow_bar",
                "keyless"
            ],
            "county": "Tartu maakond",
            "city": "Tartu",
            "headline": {
                "et": "Nelikvedu ja veokonks"
            },
            "description": {
                "et": "Müüa heas korras linnamaastur. Hooldusraamat on kaasas."
            },
            "photos": [
                "https://media.example.ee/stock/A-1057/1.jpg",
                "https://media.example.ee/stock/A-1057/2.jpg"
            ]
        },
        {
            "external_id": "A-1063",
            "make": "Škoda",
            "model": "Octavia",
            "year": 2017,
            "mileage_km": 148000,
            "price": 9800,
            "fuel": "diesel",
            "gearbox": "manual",
            "city": "Pärnu",
            "headline": {
                "et": "Ökonoomne universaal",
                "en": "An economical estate"
            },
            "description": {
                "et": "Korralik pereauto.",
                "en": "A tidy family car."
            },
            "photos": [
                "https://media.example.ee/stock/A-1063/1.jpg"
            ]
        }
    ]
}