Hooga

Edasimüüjatele ja nende IT-partneritele

Kuulutuste API

Avalda, muuda ja võta oma autosid Hooga portaalis maha otse oma laosüsteemist kohe, kui midagi muutub, ootamata faili lugemist kord tunnis. Tasuta, nagu kuulutamine isegi.

Juurdepääs antakse taotluse alusel

Seda kirjeldust võib lugeda igaüks, kuid API töötab ainult neil edasimüüjatel, kellele oleme selle sisse lülitanud. Edasimüüja profiili omanik taotleb juurdepääsu edasimüüja lehe vahekaardil API.

Kuidas juurdepääsu saada

  1. 01

    Loo edasimüüja profiil

    Logi sisse ja loo oma ettevõtte profiil. See on tasuta ja töötab kohe.

  2. 02

    Taotle juurdepääsu

    Kirjuta edasimüüja lehe vahekaardil API, millises süsteemis oma laoseisu hoiad, ja saada taotlus.

  3. 03

    Lülitame API sisse

    Vaatame taotluse üle ja vastame e-postiga. Kui API on sees, saab vahekaardil API võtmeid luua.

  4. 04

    Loo võti

    Omanik loob võtme ja annab selle sellele, kes teie süsteemi ühendab. Võtit näidatakse üks kord.

Mida API teeb ja mida mitte

  • See töötab ainult sinu enda autodega: avaldamine, muutmine, mahavõtmine ja oleku kontroll.
  • Sellel pole otsingut ja see ei tagasta midagi teiste müüjate autode kohta. See ei ole viis portaali lugemiseks.
  • Võti kuulub edasimüüjale, mitte inimesele. Võtmeid loob ja tühistab ainult profiili omanik, korraga kuni 5.
  • Võtit näidatakse üks kord, Hooga hoiab alles ainult selle sõrmejälje ja iga võti lakkab töötamast 365 päeva pärast.

Päringud

Kõik aadressid algavad nii: https://hooga.ee/api/agency/v1. Igal päringul on päis Authorization: Bearer <key>. Vastused on JSON-kujul.

PUT/listings/{external_id}
Avaldab uue auto või asendab olemasoleva. Päringu sisu on üks auto faili väljadega. external_id on sinu enda tunnus ja käib aadressi sisse. Kontrollitakse kohe, fotod ja avaldamine järgnevad minuti jooksul.
DELETE/listings/{external_id}
Võtab auto portaalist maha. Saada {"reason": "sold"}, kui auto on müüdud. Uus PUT toob selle tagasi.
GET/listings/{external_id}
Ühe auto olek ja viimase muudatuse tulemus koos põhjustega, kui see ebaõnnestus. Hoitakse alles 14 päeva.
GET/listings
Sinu autod, millel on external_id, viimati muudetud eespool, 100 lehel. Järgmise lehe saad, kui annad next_cursor väärtuse kaasa kujul ?cursor=.

Näited

Auto avaldamine või muutmine. Failis car.json on üks auto:

PUT
curl -X PUT https://hooga.ee/api/agency/v1/listings/A-1041 \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d @car.json
car.json
{
    "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]"
}

Auto läbis kontrolli ja on teel:

202 Accepted
{
    "external_id": "A-1041",
    "state": "queued",
    "message": "Accepted. The listing is published or updated in a moment; read the result with GET on the same address.",
    "warnings": []
}

Midagi kohustuslikku on puudu. Midagi ei muudetud:

422 Unprocessable Content
{
    "error": {
        "code": "invalid_listing",
        "message": "The listing was not accepted. Nothing was changed."
    },
    "problems": [
        {
            "level": "error",
            "code": "missing_price",
            "detail": null,
            "message": "The price is missing or not a number"
        }
    ]
}

Tulemuse kontroll:

GET
curl https://hooga.ee/api/agency/v1/listings/A-1041 \
  -H 'Authorization: Bearer YOUR_KEY'
200 OK
{
    "external_id": "A-1041",
    "listing": {
        "external_id": "A-1041",
        "title": "Volkswagen Golf 1.5 TSI Style · 2019",
        "status": "live",
        "is_public": true,
        "url": "https://hooga.ee/cars/volkswagen-golf-15-tsi-style-2019-4821",
        "price": 16900,
        "updated_at": "2026-11-18T10:02:11+02:00"
    },
    "last_change": {
        "state": "done",
        "result": "created",
        "accepted_at": "2026-11-18T10:01:58+02:00",
        "finished_at": "2026-11-18T10:02:11+02:00"
    }
}

Auto müüdi ära:

DELETE
curl -X DELETE https://hooga.ee/api/agency/v1/listings/A-1041 \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"reason": "sold"}'

Vastusekoodid

200
Tehtud või siin on see, mida küsisid.
202
Vastu võetud. Tulemust loe GET-päringuga.
400
Päringu sisu ei ole üks auto JSON-objektina.
401
Võti puudub või on vale, tühistatud või aegunud.
403
API ei ole sellele edasimüüjale sisse lülitatud.
404
Sul ei ole selle external_id-ga autot.
409
Hooga on selle kuulutuse maha võtnud. Seda ei saa uuesti avaldada.
413
Päring on liiga suur. Saada fotod linkidena.
422
Autot ei võetud vastu. Vastuses on kirjas, mida parandada.
429
Liiga palju päringuid. Oota nii mitu sekundit, kui ütleb Retry-After.

Reeglid ja piirangud

  • Väljad, lubatud väärtused ja kontrollid on samad mis failis. Faili leht kirjeldab iga välja.
  • Fotod on lingid, mille Hooga alla laadib (ainult https), sinu saadetud järjekorras.
  • Kuni 120 päringut minutis võtme kohta ja 3000 muudatust tunnis edasimüüja kohta, 120 päringut minutis aadressi kohta.
  • Päringu sisu võib olla kuni 256 KB.
  • Hooga portaalis käsitsi lisatud autodel external_id puudub ja API neid ei puuduta.
  • Saada auto kas faili või API kaudu, mitte mõlemat pidi: kui auto on kord failis olnud, kaob see portaalist siis, kui see failist kaob.