Дилерам и их IT-партнёрам
API объявлений
Публикуйте, обновляйте и снимайте свои автомобили на Hooga прямо из своей складской системы, как только что-то меняется, не дожидаясь ежечасного чтения файла. Бесплатно, как и само размещение.
Доступ даётся по запросу
Это описание может прочитать кто угодно, но API работает только у тех дилеров, которым мы его включили. Владелец профиля дилера запрашивает доступ на вкладке API страницы дилера.
Как получить доступ
-
01
Создайте профиль дилера
Войдите и создайте профиль своей компании. Это бесплатно и работает сразу.
-
02
Запросите доступ
На вкладке API страницы дилера напишите, в какой системе вы ведёте склад, и отправьте запрос.
-
03
Мы включаем API
Мы смотрим запрос и отвечаем по e-mail. Когда API включён, на вкладке API можно создавать ключи.
-
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 один автомобиль:
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{
"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]"
}Автомобиль прошёл проверку и уже в пути:
{
"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": []
}Не хватает чего-то обязательного. Ничего не изменено:
{
"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"
}
]
}Проверка результата:
curl https://hooga.ee/api/agency/v1/listings/A-1041 \
-H 'Authorization: Bearer YOUR_KEY'{
"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"
}
}Автомобиль продан:
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, но не обоими способами: если автомобиль однажды был в файле, он уйдёт с сайта, когда исчезнет из файла.