Коротко: в Корее большинство автомобилей на Encar продаётся с профессиональным отчётом осмотра (есть не у всех — см. has_checkup ниже) — это не «фото со всех сторон», а фиксация состояния кузова по деталям, диагностика узлов и история ДТП. Union API отдаёт этот отчёт одним запросом на русском или английском. Ниже — что именно внутри и почему это ценно и для бизнеса, и для конечного покупателя.
Что такое отчёт об осмотре и почему он важнее фотографий
В Корее перед публикацией объявления машину прогоняют через обязательную проверку (성능·상태점검). Инспектор фиксирует:
- состояние кузова по каждой детали — капот, крылья, двери, пороги, лонжероны, стойки, панель пола;
- диагностику узлов — двигатель, коробка, рулевое, тормоза, электрика, топливная система и другие;
- историю ДТП и юридическую чистоту — аварии, залоги, аресты, угон, затопление, полную гибель, смены владельцев.
На фотографиях свежепокрашенное крыло выглядит как новое. В отчёте будет видно, что это замена и что рядом рихтовали лонжерон. Именно эта разница — между «красивым объявлением» и реальным состоянием автомобиля.
Что отдаёт эндпоинт /report
GET /api/v2/cars/{car_id}/report?market=encar&lang=ru
В ответе три содержательных блока.
1. Повреждения кузова (damages)
Список деталей, по которым зафиксированы работы, и тип работ по каждой:
| Поле | Что означает |
|---|---|
code |
Код детали (P011, P061 …) |
title |
Название на языке оригинала (корейский) |
name |
Название на языке ответа (ru/en) |
status |
Тип ремонта словами — «Замена», «Рихтовка/сварка», «Вмятина» … |
status_code |
Код типа ремонта (W, WC, X, C, A, U, T) |
rank |
Ранг зоны — служебная классификация (RANK_ONE, RANK_A, RANK_B …) |
Коды типа ремонта расшифровываются так:
| Код | Значение (ru) | Значение (en) |
|---|---|---|
W |
Рихтовка/сварка | Sheet metal/welding |
WC |
Сварка/резка | Welding/cutting |
X |
Замена | Replacement |
C |
Коррозия | Corrosion |
A |
Царапина | Scratch |
U |
Вмятина | Dent |
T |
Повреждение | Damage |
Обратите внимание на стойки (P141–P146), лонжероны (P121–P124) и панель пола (P161): это силовой каркас. Работы по ним — качественно другой риск, чем царапина на двери.
2. Диагностика узлов (diagnostics)
Восемь систем: самодиагностика, двигатель, коробка передач, трансмиссия, рулевое управление, тормоза, электрика, топливная система. У каждой — состояние и элементы, которые проверяли (утечки, уровни, ресурс узлов).
3. История происшествий (accident_history)
Выжимка из открытых данных: число ДТП, ущерб по своему и чужому авто, полная гибель, затопление, число смен владельцев. Подробнее о risk-данных — в отдельном разборе.
Помимо трёх блоков, в ответе есть summary — текстовая выжимка осмотра, и billing со стоимостью списания за этот отчёт.
Пример запроса и ответа
curl -H "Authorization: Bearer <JWT>" \
"https://union.api-centr.ru/api/v2/cars/42679284/report?market=encar&lang=ru"
Реальный фрагмент ответа (автомобиль 42679284, сокращённо):
{
"market": "encar",
"car_id": 42679284,
"lang": "ru",
"has_checkup": true,
"damages": {
"count": 23,
"items": [
{"code": "P144", "title": "필러 패널(앞)(우)", "name": "Стойка передняя правая",
"status": "Рихтовка/сварка", "status_code": "W", "rank": "RANK_B"},
{"code": "P122", "title": "프론트 사이드 멤버(우)", "name": "Передний правый лонжерон",
"status": "Рихтовка/сварка", "status_code": "W", "rank": "RANK_B"}
]
},
"diagnostics": [
{"code": "S00", "title": "자기진단", "name": "Самодиагностика", "items": [
{"code": "s001", "title": "원동기", "name": "Двигатель",
"status": "Хорошо", "status_code": "1"}
]}
],
"accident_history": {
"accidentCnt": 11, "myAccidentCnt": 4, "myAccidentCost": 2808984,
"otherAccidentCnt": 7, "otherAccidentCost": 25485061,
"totalLossCnt": 0, "floodDate": null, "ownerChangeCnt": 12
}
}
Что здесь бросается в глаза: 11 ДТП (4 по своему авто, 7 по чужому) и 12 смен владельцев — при этом рихтовка/сварка на стойке и лонжероне, то есть на силовом каркасе. Такую машину вряд ли стоит рассматривать без скидки, и понять это можно за один запрос.
Параметр lang переключает язык всех наименований — ru или en. Корейский оригинал (title) остаётся рядом, для сверки и поддержки англоязычных интерфейсов.
Что это даёт бизнесу
- Дилерские и классифайд-площадки. Кнопка «Проверить авто по ID» прямо на карточке повышает доверие и конверсию. А если генерировать страницу проверки на каждый автомобиль — это ещё и длинный хвост органического поиска («проверить Hyundai Sonata из Кореи по ID»).
- Импортёры и перекупщики. Отчёт отсеивает проблемные машины ещё до выкупа и даёт аргументы для торга: стоимость ремонта и зона поражения видны за секунды.
- Боты и сервисы проверки. Telegram- или Max-бот: покупатель присылает ссылку — в ответ приходит человекочитаемый отчёт. Ничего не нужно парсить вручную.
- Страхование, лизинг, скоринг. Состояние и история по каждому авто в машиночитаемом виде — топливо для автоматических моделей риска.
- Собственная база. Скачайте интересующий сегмент рынка, разверните у себя и фильтруйте по повреждениям и диагностике без повторных запросов.
Что это даёт конечному покупателю
- Увидеть машину до поездки. Не «на слово продавца», а по протоколу профессионального осмотра.
- Понять будущий ремонт. Замена крыла и рихтовка лонжерона — разные бюджеты; отчёт разделяет их по деталям.
- Сбить цену аргументированно. Список работ и зон — готовый предмет разговора с продавцом.
- Не купить «конструктор». Замены и сварка на силовом каркасе, затопление или полная гибель видны сразу.
- Проверить узлы, а не только кузов. Диагностика показывает утечки, состояние масла, работу систем — то, что не видно на фото.
Частые вопросы
Можно ли получить отчёт без знания корейского?
Да. Параметр lang=ru (или en) возвращает наименования деталей, типов ремонта и систем на нужном языке. Корейский оригинал остаётся в поле title.
Отчёт есть для каждого автомобиля?
Нет. Поле has_checkup показывает, есть ли данные осмотра по конкретной машине. Если has_checkup: false — отчёта в источнике нет.
Сколько стоит запрос отчёта?
Формирование отчёта тарифицируется: 1 ₽ за отчёт (фиксированный точечный тариф, поле billing.report_price_rub в ответе). Безлимитные подписки на него не распространяются. Актуальные условия — на странице тарифов.
Данные только по Корее?
Эндпоинт /report сейчас работает по рынку encar (Корея). Каталог объединённого API — 11 рынков через один ключ.
Как начать
- Запросите демо-доступ к Union API.
- Получите API-ключ.
- Вызовите
/api/v2/cars/{id}/report?market=encar&lang=ruдля интересующего авто. - Выведите повреждения, диагностику и историю в своём интерфейсе или боте.
Полное описание эндпоинтов — в документации API, детали risk-данных — в справочнике по полю extra. Нужен ключ — зарегистрируйтесь.
Интегрируете проверку авто в свой продукт? Напишите нам — поможем настроить выборку и отображение отчёта.