Hooga

Дилерам и их IT-партнёрам

API объявлений

Публикуйте, обновляйте и снимайте свои автомобили на Hooga прямо из своей складской системы, как только что-то меняется, не дожидаясь ежечасного чтения файла. Бесплатно, как и само размещение.

Доступ даётся по запросу

Это описание может прочитать кто угодно, но API работает только у тех дилеров, которым мы его включили. Владелец профиля дилера запрашивает доступ на вкладке API страницы дилера.

Как получить доступ

  1. 01

    Создайте профиль дилера

    Войдите и создайте профиль своей компании. Это бесплатно и работает сразу.

  2. 02

    Запросите доступ

    На вкладке API страницы дилера напишите, в какой системе вы ведёте склад, и отправьте запрос.

  3. 03

    Мы включаем API

    Мы смотрим запрос и отвечаем по e-mail. Когда API включён, на вкладке API можно создавать ключи.

  4. 04

    Создайте ключ

    Владелец создаёт ключ и передаёт его тому, кто подключает вашу систему. Ключ показывается один раз.

Что API делает и чего не делает

  • Он работает только с вашими автомобилями: публикация, обновление, снятие и проверка состояния.
  • В нём нет поиска, и он ничего не отдаёт об автомобилях других продавцов. Это не способ читать сайт.
  • Ключ принадлежит дилеру, а не человеку. Создаёт и отзывает ключи только владелец профиля, одновременно не больше 5.
  • Ключ показывается один раз, Hooga хранит только его отпечаток, и каждый ключ перестаёт работать через 365 дней.

Запросы

Все адреса начинаются с https://hooga.ee/api/agency/v1. В каждом запросе есть заголовок Authorization: Bearer <key>. Ответы приходят в JSON.

PUT/listings/{external_id}
Публикует новый автомобиль или заменяет существующий. Тело запроса: один автомобиль с полями файла. external_id это ваш собственный номер, он указывается в адресе. Проверка сразу, фотографии и публикация в течение минуты.
DELETE/listings/{external_id}
Снимает автомобиль с сайта. Отправьте {"reason": "sold"}, если он продан. Повторный PUT вернёт его.
GET/listings/{external_id}
Состояние одного автомобиля и результат последнего изменения, с причинами, если оно не удалось. Хранится 14 дней.
GET/listings
Ваши автомобили с external_id, сначала изменённые последними, по 100 на странице. Для следующей страницы передайте next_cursor как ?cursor=.

Примеры

Публикация или обновление автомобиля. В файле car.json один автомобиль:

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

Автомобиль прошёл проверку и уже в пути:

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": []
}

Не хватает чего-то обязательного. Ничего не изменено:

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

Проверка результата:

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

Автомобиль продан:

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

Коды ответов

200
Готово, или вот то, что вы запросили.
202
Принято. Результат читайте запросом GET.
400
В теле запроса должен быть один автомобиль в формате JSON.
401
Ключа нет, либо он неверный, отозван или истёк.
403
API для этого дилера не включён.
404
У вас нет автомобиля с таким external_id.
409
Это объявление снято с Hooga. Опубликовать его снова нельзя.
413
Запрос слишком большой. Присылайте фотографии ссылками.
422
Автомобиль не принят. В ответе перечислено, что исправить.
429
Слишком много запросов. Подождите столько секунд, сколько указано в Retry-After.

Правила и ограничения

  • Поля, допустимые значения и проверки те же, что в файле. Каждое поле описано на странице файла.
  • Фотографии это ссылки, которые Hooga скачивает (только https), в том порядке, в котором вы их прислали.
  • Не больше 120 запросов в минуту на ключ и 3000 изменений в час на дилера, 120 запросов в минуту с одного адреса.
  • Тело запроса не больше 256 КБ.
  • У автомобилей, добавленных на Hooga вручную, external_id нет, и API их не трогает.
  • Передавайте автомобиль либо через файл, либо через API, но не обоими способами: если автомобиль однажды был в файле, он уйдёт с сайта, когда исчезнет из файла.