RU Марка и модель Оставить заявку

Кривой ввод → эталонная запись справочника

«тайота камри», «ВАЗ-2114», «хёндэ солярис», «мазда трёшка». Сервис отвечает записью каталога и говорит, насколько в ней уверен. От записи открывается поколение и модификация — с кузовом, мотором и коробкой.

марок
моделей
поколений
модификаций
синонимов и написаний
Примеры:
что ввелизапись справочникаисход

Подключение

Ниже тот же запрос, который делает эта страница. Разбор строки — /v1/resolve, уточнение по уже выбранному узлу — /v1/decode, подсказки — /v1/suggest.

запрос
curl -X POST https://ваш-стенд/v1/resolve \
  -H 'Authorization: Bearer $MM_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"query": "хёндэ солярис 2021"}'
ответ
{
  "result": "OK_WHITE",
  "auto_acceptable": true,
  "primary_ref": {
    "primary_id": "N7XKF…",
    "level": "model",
    "match_source": "query",
    "match_score": 1.0
  },
  "fields": {
    "mark":  { "value": "Hyundai", "source": "query", "status": "exact" },
    "model": { "value": "Solaris", "source": "query", "status": "exact" },
    "year":  { "value": 2021,      "source": "query", "status": "exact" }
  },
  "ruleset_version": "rs-10b263727b",
  "catalog_epoch": 4
}
виджет на своей странице
<script src="https://ваш-стенд/ui/sdk/mm-widgets.js" defer></script>
<div data-mm-widget="demo"></div>

Токен

/v1/resolve и /v1/decode закрыты Bearer-токеном. /v1/suggest и /v1/public/stats открыты, так что подсказки можно повесить на публичную форму, не пряча ключ в браузер.

Коды качества вместо ошибок

NO_MATCH, OK_GREY и NO_MAPPING_FOR_TARGET приходят с HTTP 200 в поле result. HTTP-ошибка означает сбой сервиса, а не данные: заявка из-за неё не встаёт в ожидание.

Ключи полей

mark, model, modification, body_type, year, segment. Прочие ключи — 422; чаще всего так ловится brand вместо mark.

Версии в ответе

ruleset_version и catalog_epoch приходят с каждым ответом. Если хранить их рядом с результатом, потом видно, по какой версии правил и какому составу справочника принято решение.

Большие объёмы

Отдельной batch-ручки нет: выгрузка гоняется теми же запросами. Под прогон поднимаем предел частоты.

SDK: Python, C#, Ruby, PHP, Elixir, JS, React Виджеты без сборки

Заявка на подключение

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