{"basePath":"/","consumes":["application/json"],"definitions":{"Car":{"description":"\u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u0430\u0432\u0442\u043e\u043c\u043e\u0431\u0438\u043b\u044f \u0441 \u0433\u043b\u0430\u0432\u043d\u044b\u043c \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435\u043c \u0438 \u043c\u0430\u0441\u0441\u0438\u0432\u043e\u043c \u0444\u043e\u0442\u043e. \u041e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u043c\u044b\u0435 \u043f\u043e\u043b\u044f `fuel_type`, `transmission`, `drive_type`, `body_type`, `color`, `country_name`, `vehicle_type_name` \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442\u0441\u044f \u043d\u0430 \u044f\u0437\u044b\u043a\u0435 \u0438\u0437 query-\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 `lang` (\u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `ru`). \u0421\u044b\u0440\u044b\u0435 \u043a\u043e\u0434\u044b (`country`, `vehicle_type`, `seller_type`, `steering_side`) \u043d\u0435 \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u044f\u0442\u0441\u044f.","properties":{"availability_type":{"description":"\u0421\u0442\u0430\u0442\u0443\u0441 \u043d\u0430\u043b\u0438\u0447\u0438\u044f (`in_stock`, `on_order`, ...) \u2014 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u044b\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u0437\u0430\u0432\u0438\u0441\u044f\u0442 \u043e\u0442 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430.","example":"in_stock","type":"string"},"body_type":{"example":"\u0441\u0435\u0434\u0430\u043d","type":"string"},"brand":{"example":"Toyota","type":"string"},"broker_rub":{"description":"\u0423\u0441\u043b\u0443\u0433\u0438 \u0431\u0440\u043e\u043a\u0435\u0440\u0430 + \u0421\u0411\u041a\u0422\u0421 + \u042d\u041f\u0422\u0421.","example":120000,"type":"integer"},"city":{"description":"\u0413\u043e\u0440\u043e\u0434, \u0433\u0434\u0435 \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u0430\u0432\u0442\u043e (\u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c `null`).","example":"\u0422\u043e\u043a\u0438\u043e","type":"string"},"color":{"example":"\u0431\u0435\u043b\u044b\u0439","type":"string"},"commission_rub":{"description":"\u041a\u043e\u043c\u0438\u0441\u0441\u0438\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u0430.","example":60000,"type":"integer"},"company_id":{"description":"UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438, \u0434\u043b\u044f \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043f\u043e\u0441\u0447\u0438\u0442\u0430\u043d\u0430 \u044d\u0442\u0430 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0430. `null` \u0432 \u0432\u0438\u0442\u0440\u0438\u043d\u043d\u043e\u043c \u0440\u0435\u0436\u0438\u043c\u0435 (\u0437\u0430\u043f\u0440\u043e\u0441 \u0431\u0435\u0437 `company_id`).","example":"3269aded-e5bd-4b33-b288-50d0c33b8945","format":"uuid","type":"string"},"contacts":{"description":"\u041f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0435 \u043a\u043e\u043d\u0442\u0430\u043a\u0442\u044b, \u043f\u0440\u0438\u0432\u044f\u0437\u0430\u043d\u043d\u044b\u0435 \u043a \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0435. \u0418\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u2014 `dealer.proride.io/api/site/companies/{uuid}` \u0435\u0441\u043b\u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u043d `company_id`, \u0438\u043d\u0430\u0447\u0435 \u043e\u0431\u0449\u0438\u0435 \u043a\u043e\u043d\u0442\u0430\u043a\u0442\u044b \u043f\u043b\u043e\u0449\u0430\u0434\u043a\u0438 (`null`, \u043a\u043e\u0433\u0434\u0430 \u0443 \u043f\u043b\u043e\u0449\u0430\u0434\u043a\u0438 \u043e\u043d\u0438 \u043d\u0435 \u043d\u0430\u0441\u0442\u0440\u043e\u0435\u043d\u044b). \u0412 \u043e\u0442\u0432\u0435\u0442\u0430\u0445 \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0441\u043f\u0438\u0441\u043a\u0430 (`/v1/cars`, `/v1/chat`) \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 **\u043d\u0430 \u0432\u0435\u0440\u0445\u043d\u0435\u043c \u0443\u0440\u043e\u0432\u043d\u0435**, \u0430 \u043d\u0435 \u0432\u043d\u0443\u0442\u0440\u0438 \u043a\u0430\u0436\u0434\u043e\u0439 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u2014 \u0437\u0434\u0435\u0441\u044c \u043f\u043e\u043b\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u0434\u043b\u044f \u0441\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u043d\u043e\u0441\u0442\u0438 \u0441\u0445\u0435\u043c\u044b \u0434\u0435\u0442\u0430\u043b\u044c\u043d\u043e\u0439 \u0440\u0443\u0447\u043a\u0438.","properties":{"address":{"example":"\u041c\u043e\u0441\u043a\u0432\u0430, \u0422\u0432\u0435\u0440\u0441\u043a\u0430\u044f 1","type":"string"},"city":{"example":"\u041c\u043e\u0441\u043a\u0432\u0430","type":"string"},"company_name":{"example":"\u0410\u0432\u0442\u043e\u0414\u0438\u043b\u0435\u0440","type":"string"},"email_public":{"example":"sales@example.com","type":"string"},"logo_url":{"example":"https://dealer.proride.io/logos/uuid.png","type":"string"},"max_bot_username":{"example":"autodealer_max_bot","type":"string"},"max_url":{"example":"https://max.ru/autodealer","type":"string"},"phone":{"example":"+7 999 000-00-00","type":"string"},"telegram_bot_username":{"example":"autodealer_bot","type":"string"},"telegram_channel":{"example":"@autodealer","type":"string"},"telegram_personal":{"example":"@manager","type":"string"},"vk_url":{"example":"https://vk.com/autodealer","type":"string"},"work_hours":{"example":"10:00 \u2014 20:00","type":"string"}},"type":"object"},"country":{"example":"japan","type":"string"},"country_name":{"example":"\u042f\u043f\u043e\u043d\u0438\u044f","type":"string"},"customs_rub":{"description":"\u0422\u0430\u043c\u043e\u0436\u0435\u043d\u043d\u044b\u0439 \u0441\u0431\u043e\u0440.","example":4924,"type":"integer"},"delivery_rub":{"description":"\u0414\u043e\u0441\u0442\u0430\u0432\u043a\u0430 \u0434\u043e \u0442\u043e\u0447\u043a\u0438 \u0432\u044b\u0434\u0430\u0447\u0438 \u0432 \u0420\u0424.","example":319220,"type":"integer"},"drive_type":{"example":"FWD","type":"string"},"duty_rub":{"description":"\u041f\u043e\u0448\u043b\u0438\u043d\u0430 + \u0430\u043a\u0446\u0438\u0437 + \u041d\u0414\u0421.","example":490000,"type":"integer"},"engine_volume":{"description":"\u041e\u0431\u044a\u0451\u043c \u0434\u0432\u0438\u0433\u0430\u0442\u0435\u043b\u044f \u0432 **\u043c\u0438\u043b\u043b\u0438\u043b\u0438\u0442\u0440\u0430\u0445** (2500 = 2.5 \u043b).","example":2500,"type":"integer"},"fuel_type":{"example":"\u0431\u0435\u043d\u0437\u0438\u043d","type":"string"},"gallery":{"description":"\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0441\u043b\u043e\u0442\u044b \u0433\u0430\u043b\u0435\u0440\u0435\u0438 (\u0431\u0435\u0437 \u0433\u043b\u0430\u0432\u043d\u043e\u0433\u043e \u2014 \u043e\u043d \u0432 `img_main`). \u0422\u043e\u043b\u044c\u043a\u043e URL \u043d\u0430 CDN `img.gumy.space`, \u0431\u0435\u0437 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f. \u041f\u0443\u0441\u0442\u043e\u0439 \u043c\u0430\u0441\u0441\u0438\u0432, \u0435\u0441\u043b\u0438 \u0434\u043e\u043f. \u0444\u043e\u0442\u043e \u043d\u0435\u0442.","example":["https://img.gumy.space/photos/che168/87941298_2","https://img.gumy.space/photos/che168/87941298_3","https://img.gumy.space/photos/che168/87941298_4"],"items":{"type":"string"},"type":"array"},"gallery_jpg":{"description":"JPEG-\u0432\u0430\u0440\u0438\u0430\u043d\u0442\u044b \u0441\u043b\u043e\u0442\u043e\u0432 \u0433\u0430\u043b\u0435\u0440\u0435\u0438 \u043d\u0430 CDN `img.gumy.space` (\u043e\u043f\u0442\u0438\u043c\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u044b \u0434\u043b\u044f \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u043e\u0432 \u2014 \u0441\u0443\u0444\u0444\u0438\u043a\u0441 `_tg.jpg`, \u043f\u043e\u043b\u043d\u044b\u0439 URL \u0441 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435\u043c). \u0414\u043e 5 URL. \u041f\u0443\u0441\u0442\u043e\u0439 \u043c\u0430\u0441\u0441\u0438\u0432, \u0435\u0441\u043b\u0438 \u0443 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u043d\u0435\u0442 JPEG-\u043a\u043e\u043f\u0438\u0439.","example":["https://img.gumy.space/photos/autospot/3951176_tg.jpg","https://img.gumy.space/photos/autospot/3951176_2_tg.jpg","https://img.gumy.space/photos/autospot/3951176_3_tg.jpg"],"items":{"type":"string"},"maxItems":5,"type":"array"},"has_accident":{"description":"\u041f\u0440\u0438\u0437\u043d\u0430\u043a \u0414\u0422\u041f. `1` \u2014 \u0431\u044b\u043b \u0432 \u0414\u0422\u041f (\u043f\u043e \u0434\u0430\u043d\u043d\u044b\u043c \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430), `0` \u2014 \u0431\u0435\u0437 \u0430\u0432\u0430\u0440\u0438\u0439, `null` \u2014 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043d\u0435 \u0441\u043e\u043e\u0431\u0449\u0430\u0435\u0442.","enum":[0,1],"example":0,"type":"integer"},"id":{"example":12345,"type":"integer"},"img_main":{"description":"\u0413\u043b\u0430\u0432\u043d\u043e\u0435 \u0444\u043e\u0442\u043e \u0434\u043b\u044f \u043a\u0430\u0442\u0430\u043b\u043e\u0436\u043d\u043e\u0439 \u043f\u043b\u0438\u0442\u043a\u0438. \u0411\u0430\u0437\u043e\u0432\u044b\u0439 URL \u043d\u0430 CDN `img.gumy.space` **\u0431\u0435\u0437 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f** \u2014 \u043a\u043b\u0438\u0435\u043d\u0442 \u0441\u0430\u043c \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u0440\u0430\u0437\u043c\u0435\u0440\u043d\u044b\u0439 \u0441\u0443\u0444\u0444\u0438\u043a\u0441 (`_sm.webp` / `_md.webp`) \u043f\u043e\u0434 \u043d\u0443\u0436\u043d\u044b\u0439 \u0440\u0430\u0437\u043c\u0435\u0440. `null`, \u0435\u0441\u043b\u0438 \u0443 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u043d\u0435\u0442 \u043d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e \u0444\u043e\u0442\u043e \u043d\u0430 \u043d\u0430\u0448\u0435\u043c CDN.","example":"https://img.gumy.space/photos/che168/87941298","type":"string"},"is_new":{"description":"`1` \u2014 \u043d\u043e\u0432\u043e\u0435 \u0430\u0432\u0442\u043e, `0` \u2014 \u0441 \u043f\u0440\u043e\u0431\u0435\u0433\u043e\u043c.","enum":[0,1],"example":0,"type":"integer"},"latitude":{"description":"\u0428\u0438\u0440\u043e\u0442\u0430 (\u0446\u0435\u043d\u0442\u0440\u043e\u0438\u0434 \u0433\u043e\u0440\u043e\u0434\u0430 \u0438\u0437 `ref_cities`). `null`, \u0435\u0441\u043b\u0438 \u0433\u043e\u0440\u043e\u0434\u0430 \u043d\u0435\u0442 \u0432 \u0433\u0435\u043e-\u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a\u0435. \u0422\u043e\u0447\u043d\u043e\u0441\u0442\u044c \u2014 \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0433\u043e\u0440\u043e\u0434\u0430, \u043d\u0435 \u0430\u0434\u0440\u0435\u0441\u0430.","example":55.755864,"format":"float","type":"number"},"longitude":{"description":"\u0414\u043e\u043b\u0433\u043e\u0442\u0430 (\u0446\u0435\u043d\u0442\u0440\u043e\u0438\u0434 \u0433\u043e\u0440\u043e\u0434\u0430 \u0438\u0437 `ref_cities`). \u041f\u0430\u0440\u043d\u0430\u044f \u043a `latitude` \u2014 \u043b\u0438\u0431\u043e \u043e\u0431\u0435 \u0437\u0430\u043f\u043e\u043b\u043d\u0435\u043d\u044b, \u043b\u0438\u0431\u043e \u043e\u0431\u0435 `null`.","example":37.617698,"format":"float","type":"number"},"mileage":{"description":"\u041f\u0440\u043e\u0431\u0435\u0433, \u043a\u043c.","example":45000,"type":"integer"},"model":{"example":"Camry","type":"string"},"modification_id":{"description":"FK \u043d\u0430 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0439 (`modification.gumy.space`). `null`, \u0435\u0441\u043b\u0438 catalog \u043d\u0435 \u043d\u0430\u0448\u0451\u043b \u0443\u0432\u0435\u0440\u0435\u043d\u043d\u043e\u0433\u043e match \u2014 ~10% \u0441\u0442\u0440\u043e\u043a. \u0420\u0435\u0437\u043e\u043b\u0432\u0438\u0442\u044c \u043f\u043e\u043b\u043d\u0443\u044e \u0441\u043f\u0435\u043a\u0443: `GET https://modification.gumy.space/v1/modifications/{modification_id}`. \u0422\u0430\u043a\u0436\u0435 \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u043c: `/v1/cars?modification_id=` (\u043e\u0434\u0438\u043d\u043e\u0447\u043d\u044b\u0439) \u0438\u043b\u0438 `/v1/cars?modification_ids=` (CSV). \u0421\u043c. ADR-0028.","example":79221,"type":"integer"},"modification_image":{"description":"\u0421\u0442\u0443\u0434\u0438\u0439\u043d\u044b\u0439 \u0440\u0435\u043d\u0434\u0435\u0440 \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 (\u041d\u0415 \u0444\u043e\u0442\u043e \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f) \u0441 CDN `modification.gumy.space`. \u0422\u0440\u0438 \u0433\u043e\u0442\u043e\u0432\u044b\u0445 \u0440\u0430\u0437\u043c\u0435\u0440\u0430 webp: `small` (thumb), `medium` (card), `big` (stage) \u2014 \u043f\u043e\u043b\u043d\u044b\u0435 URL \u0441 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435\u043c, \u0431\u0440\u0430\u0442\u044c \u043a\u0430\u043a \u0435\u0441\u0442\u044c, \u0441\u0443\u0444\u0444\u0438\u043a\u0441 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0442\u044c \u043d\u0435 \u043d\u0443\u0436\u043d\u043e. \u041f\u0440\u0438\u0432\u044f\u0437\u0430\u043d \u043a `modification_id` \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043e\u0434\u0438\u043d\u0430\u043a\u043e\u0432 \u0434\u043b\u044f \u0432\u0441\u0435\u0445 \u0430\u0432\u0442\u043e \u043e\u0434\u043d\u043e\u0439 \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438. `null`, \u0435\u0441\u043b\u0438 \u0443 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u043d\u0435\u0442 `modification_id` \u0438\u043b\u0438 \u0434\u043b\u044f \u044d\u0442\u043e\u0439 \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0440\u0435\u043d\u0434\u0435\u0440 \u0435\u0449\u0451 \u043d\u0435 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d (~10\u201315% \u0441\u0442\u0440\u043e\u043a). \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043a\u0430\u043a fallback-\u043a\u0430\u0440\u0442\u0438\u043d\u043a\u0443, \u043a\u043e\u0433\u0434\u0430 \u0443 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u043d\u0435\u0442 \u0441\u043e\u0431\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0445 \u0444\u043e\u0442\u043e (`img_main` = `null`), \u043b\u0438\u0431\u043e \u0434\u043b\u044f \u0435\u0434\u0438\u043d\u043e\u043e\u0431\u0440\u0430\u0437\u043d\u043e\u0439 \u043f\u043b\u0438\u0442\u043a\u0438 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430.","nullable":true,"properties":{"big":{"example":"https://modification.gumy.space/images/render-web/volkswagen-golf-white@stage.webp","type":"string"},"medium":{"example":"https://modification.gumy.space/images/render-web/volkswagen-golf-white@card.webp","type":"string"},"small":{"example":"https://modification.gumy.space/images/render-web/volkswagen-golf-white@thumb.webp","type":"string"}},"type":"object"},"owner_count":{"description":"\u041a\u043e\u043b-\u0432\u043e \u0432\u043b\u0430\u0434\u0435\u043b\u044c\u0446\u0435\u0432. `null` \u0435\u0441\u043b\u0438 \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u043e.","example":1,"type":"integer"},"power_hp":{"description":"\u041c\u043e\u0449\u043d\u043e\u0441\u0442\u044c \u0434\u0432\u0438\u0433\u0430\u0442\u0435\u043b\u044f, \u043b.\u0441. \u041c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c `null`.","example":203,"type":"integer"},"price_breakdown":{"description":"\u041f\u043e\u043b\u043d\u0430\u044f \u0440\u0430\u0437\u0431\u0438\u0432\u043a\u0430 `total_price_rub` \u043f\u043e \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u0430\u043c. \u0412 \u043e\u0431\u044a\u0435\u043a\u0442\u0435 \u043f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0435\u043d\u0443\u043b\u0435\u0432\u044b\u0435 \u043a\u043b\u044e\u0447\u0438 \u2014 \u0434\u043b\u044f \u0440\u043e\u0441\u0441\u0438\u0439\u0441\u043a\u043e\u0433\u043e \u0430\u0432\u0442\u043e \u0431\u0435\u0437 \u0440\u0430\u0441\u0442\u0430\u043c\u043e\u0436\u043a\u0438 \u043e\u0441\u0442\u0430\u043d\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e `price_rub`. \u041a\u043b\u044e\u0447 `company_markup_rub` \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043a\u043e\u0433\u0434\u0430 \u0437\u0430\u043f\u0440\u043e\u0441 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 `company_id`, \u0443 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 \u0432\u044b\u0441\u0442\u0430\u0432\u043b\u0435\u043d\u0430 \u043d\u0435\u043d\u0443\u043b\u0435\u0432\u0430\u044f \u043a\u043e\u043c\u0438\u0441\u0441\u0438\u044f (`pricing_*`), \u0438 \u043e\u043d\u0430 \u043f\u0440\u0438\u0431\u0430\u0432\u043b\u0435\u043d\u0430 \u043a `total_price_rub`.","properties":{"broker_rub":{"example":120000,"type":"integer"},"commission_rub":{"example":60000,"type":"integer"},"company_markup_rub":{"description":"\u041d\u0430\u0446\u0435\u043d\u043a\u0430 \u0434\u0438\u043b\u0435\u0440\u0430, \u0440\u0430\u0441\u0441\u0447\u0438\u0442\u0430\u043d\u043d\u0430\u044f \u043f\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u0430\u043c \u0438\u0437 `dealer.proride.io` (\u043f\u043e\u043b\u044f `pricing_mode` + `pricing_percent` / `pricing_fixed`). \u041f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0432 \u043e\u0442\u0432\u0435\u0442\u0430\u0445 \u0441 `company_id`.","example":20800,"type":"integer"},"customs_rub":{"example":4924,"type":"integer"},"delivery_rub":{"example":319220,"type":"integer"},"duty_rub":{"example":490000,"type":"integer"},"price_rub":{"example":1040000,"type":"integer"},"recycling_fee_rub":{"example":3400,"type":"integer"}},"type":"object"},"price_context":{"description":"\u041a\u043e\u043d\u0442\u0435\u043a\u0441\u0442 \u0446\u0435\u043d\u044b: \u043d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u00ab\u043f\u043e\u0434 \u043a\u043b\u044e\u0447\u00bb \u0446\u0435\u043d\u0430 \u044d\u0442\u043e\u0433\u043e \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0430 (`total_price_rub`) \u0432\u044b\u0448\u0435 \u0438\u043b\u0438 \u043d\u0438\u0436\u0435 \u043c\u0435\u0434\u0438\u0430\u043d\u044b \u0446\u0435\u043d\u044b **\u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u043e\u0433\u043e \u0430\u0432\u0442\u043e** \u2014 \u0442\u043e\u0439 \u0436\u0435 \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 (`modification_id`: \u043c\u0430\u0440\u043a\u0430 + \u043c\u043e\u0434\u0435\u043b\u044c + \u043f\u043e\u043a\u043e\u043b\u0435\u043d\u0438\u0435 + \u0434\u0432\u0438\u0433\u0430\u0442\u0435\u043b\u044c + \u043a\u043e\u043c\u043f\u043b\u0435\u043a\u0442\u0430\u0446\u0438\u044f). \u0421\u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u0432\u0438\u0442\u0440\u0438\u043d\u043d\u043e\u0439 \u0431\u0430\u0437\u043e\u0432\u043e\u0439 \u0446\u0435\u043d\u0435, **\u0434\u043e** \u0434\u0438\u043b\u0435\u0440\u0441\u043a\u043e\u0439 \u043d\u0430\u0446\u0435\u043d\u043a\u0438, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 `diff_pct` \u0434\u0438\u043b\u0435\u0440\u043e-\u043d\u0435\u0439\u0442\u0440\u0430\u043b\u0435\u043d. \u041f\u043e\u043b\u0435 \u0440\u0430\u0432\u043d\u043e `null`, \u043a\u043e\u0433\u0434\u0430 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442 \u043d\u0435 \u0432\u044b\u0447\u0438\u0441\u043b\u0438\u043c: \u0443 \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0430 \u043d\u0435\u0442 `modification_id`, \u043c\u0435\u0434\u0438\u0430\u043d\u0430 \u043f\u043e\u0441\u0442\u0440\u043e\u0435\u043d\u0430 \u043c\u0435\u043d\u044c\u0448\u0435 \u0447\u0435\u043c \u043d\u0430 5 \u0446\u0435\u043d\u043e\u0432\u044b\u0445 \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0430\u0445, \u0438\u043b\u0438 \u043c\u0435\u0434\u0438\u0430\u043d\u0430 \u2264 0 \u2014 \u0447\u0435\u0441\u0442\u043d\u044b\u0439 `null` \u0432\u043c\u0435\u0441\u0442\u043e \u043f\u0440\u043e\u0446\u0435\u043d\u0442\u0430 \u043f\u0440\u043e\u0442\u0438\u0432 \u0434\u0432\u0443\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439.","properties":{"basis":{"description":"\u0427\u0442\u043e \u0437\u043d\u0430\u0447\u0438\u0442 \u00ab\u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u044b\u0439\u00bb; \u0441\u0435\u0439\u0447\u0430\u0441 \u0432\u0441\u0435\u0433\u0434\u0430 `modification`.","enum":["modification"],"example":"modification","type":"string"},"diff_pct":{"description":"\u041e\u0442\u043a\u043b\u043e\u043d\u0435\u043d\u0438\u0435 \u0446\u0435\u043d\u044b \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0430 \u043e\u0442 \u043c\u0435\u0434\u0438\u0430\u043d\u044b, \u0441\u043e \u0437\u043d\u0430\u043a\u043e\u043c: `round((total_price_rub \u2212 median)/median\u00d7100, 1)`. \u041e\u0442\u0440\u0438\u0446\u0430\u0442\u0435\u043b\u044c\u043d\u043e\u0435 \u2014 \u0434\u0435\u0448\u0435\u0432\u043b\u0435 \u043c\u0435\u0434\u0438\u0430\u043d\u044b, \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0435 \u2014 \u0434\u043e\u0440\u043e\u0436\u0435.","example":1.9,"format":"float","type":"number"},"median_price_rub":{"description":"\u041c\u0435\u0434\u0438\u0430\u043d\u0430 `total_price_rub` \u043f\u043e \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u043c \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0430\u043c \u0442\u043e\u0439 \u0436\u0435 \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0441 \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u043e\u0439 \u0446\u0435\u043d\u043e\u0439 (`percentile_cont(0.5)`).","example":2090000,"type":"integer"},"peer_count":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u043e\u0432 \u0444\u043e\u0440\u043c\u0438\u0440\u0443\u044e\u0442 \u043c\u0435\u0434\u0438\u0430\u043d\u0443.","example":14,"type":"integer"},"verdict":{"description":"\u0411\u0430\u043a\u0435\u0442 \u0434\u043e\u0432\u0435\u0440\u0438\u044f \u043e\u0442 `diff_pct`: `below_market` (\u0437\u0430\u043c\u0435\u0442\u043d\u043e \u0434\u0435\u0448\u0435\u0432\u043b\u0435 \u0440\u044b\u043d\u043a\u0430), `at_market` (\u043e\u043a\u043e\u043b\u043e \u043c\u0435\u0434\u0438\u0430\u043d\u044b), `above_market` (\u0437\u0430\u043c\u0435\u0442\u043d\u043e \u0434\u043e\u0440\u043e\u0436\u0435).","enum":["below_market","at_market","above_market"],"example":"at_market","type":"string"}},"type":"object","x-nullable":true},"price_converted":{"description":"\u0426\u0435\u043d\u044b \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u0432 \u0432\u0430\u043b\u044e\u0442\u0435 `?currency=` (\u0430\u0434\u0434\u0438\u0442\u0438\u0432\u043d\u044b\u0439 \u0431\u043b\u043e\u043a, \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u0438 `currency != RUB`). \u041a\u0430\u043d\u043e\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0435 `total_price_rub` / `price_rub` / `price_breakdown.*_rub` **\u043d\u0435 \u043c\u0435\u043d\u044f\u044e\u0442\u0441\u044f** \u2014 \u044d\u0442\u043e \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0430\u0446\u0438\u044f \u043f\u043e\u0432\u0435\u0440\u0445, \u0430 \u043d\u0435 \u0432\u043c\u0435\u0441\u0442\u043e. \u041a\u0443\u0440\u0441 \u0444\u0438\u043a\u0441\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u044b\u0439, \u0442\u043e\u0442 \u0436\u0435 \u0447\u0442\u043e \u0443 \u0432\u0430\u043b\u044e\u0442\u043d\u044b\u0445 \u0446\u0435\u043d\u043e\u0432\u044b\u0445 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432 \u043d\u0430 \u0432\u0445\u043e\u0434\u0435; \u043f\u0443\u0431\u043b\u0438\u043a\u0443\u0435\u0442\u0441\u044f \u0432 `rate`.","properties":{"breakdown":{"description":"\u041a\u0430\u0436\u0434\u044b\u0439 \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0439 \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442 `price_breakdown.<part>_rub`, \u043f\u0435\u0440\u0435\u0432\u0435\u0434\u0451\u043d\u043d\u044b\u0439 \u0432 \u0432\u0430\u043b\u044e\u0442\u0443 (\u0441\u0443\u0444\u0444\u0438\u043a\u0441 `_rub` \u0441\u043d\u044f\u0442): `delivery`, `duty`, `customs`, `company_markup`, \u2026","type":"object"},"currency":{"description":"\u041a\u043e\u0434 \u0432\u0430\u043b\u044e\u0442\u044b \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0430\u0446\u0438\u0438 (uppercase).","example":"USD","type":"string"},"price":{"description":"`round(price_rub / rate)`, \u0435\u0441\u043b\u0438 `price_rub` \u043f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u0435\u0442 \u0438 \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u0435\u043b\u044c\u043d\u0430.","example":12000,"type":"integer"},"rate":{"description":"\u0420\u0443\u0431\u043b\u0435\u0439 \u0437\u0430 1 \u0435\u0434\u0438\u043d\u0438\u0446\u0443 `currency`. \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u044f = `round(<rub> / rate)`.","example":90.0,"format":"float","type":"number"},"total_price":{"description":"`round(total_price_rub / rate)` \u2014 \u0446\u0435\u043d\u0430 \u00ab\u043f\u043e\u0434 \u043a\u043b\u044e\u0447\u00bb \u0432 \u0432\u0430\u043b\u044e\u0442\u0435.","example":13717,"type":"integer"}},"type":"object"},"price_rub":{"description":"\u0411\u0430\u0437\u043e\u0432\u0430\u044f \u0446\u0435\u043d\u0430 \u0430\u0432\u0442\u043e \u0432 \u0441\u0442\u0440\u0430\u043d\u0435-\u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0435, \u0431\u0435\u0437 \u0434\u043e\u0441\u0442\u0430\u0432\u043a\u0438/\u043f\u043e\u0448\u043b\u0438\u043d/\u0441\u0431\u043e\u0440\u043e\u0432.","example":1040000,"type":"integer"},"recycling_fee_rub":{"description":"\u0423\u0442\u0438\u043b\u0438\u0437\u0430\u0446\u0438\u043e\u043d\u043d\u044b\u0439 \u0441\u0431\u043e\u0440.","example":3400,"type":"integer"},"seller_type":{"description":"\u0422\u0438\u043f \u043f\u0440\u043e\u0434\u0430\u0432\u0446\u0430: \u0434\u0438\u043b\u0435\u0440 \u0438\u043b\u0438 \u0447\u0430\u0441\u0442\u043d\u043e\u0435 \u043b\u0438\u0446\u043e.","enum":["dealer","private"],"example":"dealer","type":"string"},"source_url":{"description":"\u0421\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043f\u0435\u0440\u0432\u043e\u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f (\u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430 \u0443 \u0434\u0438\u043b\u0435\u0440\u0430 / \u043d\u0430 \u043f\u0430\u0440\u0442\u043d\u0451\u0440\u0441\u043a\u043e\u0439 \u043f\u043b\u043e\u0449\u0430\u0434\u043a\u0435). `null`, \u0435\u0441\u043b\u0438 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043d\u0435 \u0441\u043e\u0445\u0440\u0430\u043d\u0438\u043b URL.","example":"https://che168.com/dealer/12345.html","type":"string"},"steering_side":{"description":"\u0421\u0442\u043e\u0440\u043e\u043d\u0430 \u0440\u0443\u043b\u044f. \u041e\u0441\u043e\u0431\u0435\u043d\u043d\u043e \u0432\u0430\u0436\u043d\u043e \u0434\u043b\u044f \u0430\u0432\u0442\u043e \u0438\u0437 \u042f\u043f\u043e\u043d\u0438\u0438 (\u0447\u0430\u0441\u0442\u043e `right`). `null` \u0435\u0441\u043b\u0438 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043d\u0435 \u0441\u043e\u043e\u0431\u0449\u0430\u0435\u0442.","enum":["left","right"],"example":"left","type":"string"},"total_price_rub":{"description":"\u0418\u0442\u043e\u0433\u043e\u0432\u0430\u044f \u0446\u0435\u043d\u0430 \u00ab\u043f\u043e\u0434 \u043a\u043b\u044e\u0447\u00bb (\u0441\u043c. `price_breakdown`).","example":2040000,"type":"integer"},"total_score":{"description":"\u0421\u043a\u043e\u0440\u0438\u043d\u0433 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f (0\u2013100, smallint). \u0427\u0435\u043c \u0432\u044b\u0448\u0435 \u2014 \u0442\u0435\u043c \u00ab\u043b\u0443\u0447\u0448\u0435\u00bb \u043b\u043e\u0442. \u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u0432 `/v1/chat` \u043e\u0442\u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u044b \u043f\u043e \u044d\u0442\u043e\u043c\u0443 \u043f\u043e\u043b\u044e \u043f\u043e \u0443\u0431\u044b\u0432\u0430\u043d\u0438\u044e.","example":42,"type":"integer"},"transmission":{"example":"AT","type":"string"},"trim":{"description":"\u041a\u043e\u043c\u043f\u043b\u0435\u043a\u0442\u0430\u0446\u0438\u044f (\u0435\u0441\u043b\u0438 \u0443 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u0435\u0441\u0442\u044c).","example":"Camry 2.5 Elegance","type":"string"},"url":{"description":"\u041f\u0443\u0431\u043b\u0438\u0447\u043d\u0430\u044f \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0443 \u0430\u0432\u0442\u043e","example":"https://proride.io/catalog/toyota/12345","type":"string"},"vehicle_type":{"example":"car","type":"string"},"year":{"example":2022,"type":"integer"}},"type":"object"},"ChatResponse":{"properties":{"cars":{"description":"\u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u043f\u043e\u0434\u0445\u043e\u0434\u044f\u0449\u0438\u0445 \u0430\u0432\u0442\u043e (\u043d\u0435 \u0431\u043e\u043b\u0435\u0435 `limit`, \u0441\u0434\u0432\u0438\u0433\u0430\u044e\u0442\u0441\u044f \u043f\u043e `offset`)","items":{"$ref":"#/definitions/Car"},"type":"array"},"company_id":{"description":"\u042d\u0445\u043e \u043f\u0435\u0440\u0435\u0434\u0430\u043d\u043d\u043e\u0433\u043e \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 `company_id` (UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438-\u0434\u0438\u043b\u0435\u0440\u0430, \u0432 \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u0435 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u0448\u0451\u043b \u043f\u043e\u0438\u0441\u043a). `null` \u2014 \u0435\u0441\u043b\u0438 \u0437\u0430\u043f\u0440\u043e\u0441 \u043f\u0440\u0438\u0448\u0451\u043b \u0431\u0435\u0437 `company_id` (\u0432\u0438\u0442\u0440\u0438\u043d\u043d\u044b\u0439 \u0440\u0435\u0436\u0438\u043c).","format":"uuid","type":"string"},"contacts":{"$ref":"#/definitions/Car/properties/contacts"},"filters_applied":{"description":"\u0424\u0438\u043b\u044c\u0442\u0440\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 AI \u0438\u0437\u0432\u043b\u0451\u043a \u0438\u0437 \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u0438 \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u043f\u0440\u0438\u043c\u0435\u043d\u0438\u043b \u043a \u043f\u043e\u0438\u0441\u043a\u0443. \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043e\u0442\u0440\u0438\u0441\u043e\u0432\u0430\u0442\u044c \u0431\u043b\u043e\u043a \u00ab\u041f\u0440\u0438\u043c\u0435\u043d\u0451\u043d\u043d\u044b\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b\u00bb \u043e\u0434\u043d\u0438\u043c \u0432\u044b\u0437\u043e\u0432\u043e\u043c, \u0431\u0435\u0437 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0433\u043e \u043f\u043e\u0445\u043e\u0434\u0430 \u0432 /v1/search/parse. \u041a\u043b\u044e\u0447\u0438: `brand`, `model`, `body_type`, `fuel_type`, `transmission`, `drive_type`, `color`, `country`, `min_price`, `max_price`, `min_year`, `max_year`, `max_mileage`, `min_mileage`, `min_engine`, `max_engine`, `min_power`, `max_power`, `is_new`, `vehicle_type`. \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u2014 \u0441\u0442\u0440\u043e\u043a\u0438, \u0447\u0438\u0441\u043b\u0430 \u0438\u043b\u0438 \u043c\u0430\u0441\u0441\u0438\u0432\u044b (\u0434\u043b\u044f multi-value: \u00abbmw \u0438\u043b\u0438 kia\u00bb \u2192 `[\"BMW\", \"Kia\"]`).","example":{"brand":"Ferrari","color":"\u041a\u0440\u0430\u0441\u043d\u044b\u0439","vehicle_type":"car"},"type":"object"},"has_more":{"description":"\u0415\u0441\u0442\u044c \u043b\u0438 \u0435\u0449\u0451 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b \u2014 \u0444\u043b\u0430\u0433 \u0434\u043b\u044f \u043a\u043d\u043e\u043f\u043a\u0438 \u00ab\u0415\u0449\u0451\u00bb. \u0417\u0430\u043f\u0440\u043e\u0441\u0438\u0442\u044c \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0443\u044e \u043f\u0430\u0447\u043a\u0443: \u043f\u043e\u0432\u0442\u043e\u0440\u0438\u0442\u044c \u0437\u0430\u043f\u0440\u043e\u0441 \u0441 `offset = offset + limit`.","example":true,"type":"boolean"},"limit":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u043a\u0430\u0440\u0442\u043e\u0447\u0435\u043a \u0432\u0435\u0440\u043d\u0443\u043b\u043e\u0441\u044c \u0432 \u044d\u0442\u043e\u0439 \u043f\u0430\u0447\u043a\u0435.","example":8,"type":"integer"},"offset":{"description":"\u0421\u043c\u0435\u0449\u0435\u043d\u0438\u0435 \u0432 \u043e\u0431\u0449\u0435\u043c \u043d\u0430\u0431\u043e\u0440\u0435 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432.","example":0,"type":"integer"},"text":{"description":"\u0422\u0435\u043a\u0441\u0442\u043e\u0432\u044b\u0439 \u043e\u0442\u0432\u0435\u0442 AI-\u0430\u0433\u0435\u043d\u0442\u0430","example":"\u041d\u0430\u0448\u0451\u043b 127 \u043f\u043e \u0432\u0430\u0448\u0435\u043c\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u0443.","type":"string"},"total":{"description":"\u0412\u0441\u0435\u0433\u043e \u043d\u0430\u0439\u0434\u0435\u043d\u043e \u043f\u043e \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u043c.","example":127,"type":"integer"}},"type":"object"},"Error":{"properties":{"error":{"example":"invalid or missing X-API-Key","type":"string"}},"type":"object"},"FactoryPlant":{"description":"\u041e\u0434\u0438\u043d \u0434\u0435\u0439\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0439 \u0430\u0432\u0442\u043e\u0437\u0430\u0432\u043e\u0434 \u0434\u043b\u044f \u043a\u0430\u0440\u0442\u044b \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0435\u043b\u0435\u0439. \u0418\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u2014 `frontend.factory_plant` (\u043a\u0430\u0442\u0430\u043b\u043e\u0433 \u0441\u0442\u0440\u043e\u0438\u0442 \u0438\u0437 \u0441\u0445\u0435\u043c\u044b `factory`). \u0412 \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0435 `GET /v1/factories` \u043f\u043e\u043b\u0435 `models` \u043e\u043f\u0443\u0449\u0435\u043d\u043e (\u0435\u0434\u0435\u0442 \u0432 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0435 `GET /v1/factories/{id}`).","properties":{"annual_capacity_units":{"description":"\u0413\u043e\u0434\u043e\u0432\u0430\u044f \u043c\u043e\u0449\u043d\u043e\u0441\u0442\u044c (\u0448\u0442.), \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c null.","example":100000,"type":"integer"},"brand_slugs":{"description":"\u0422\u043e\u043b\u044c\u043a\u043e \u0432 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0435 `GET /v1/factories/{id}`: \u0440\u0430\u0441\u043f\u043e\u0437\u043d\u0430\u043d\u043d\u044b\u0435 slug'\u0438 \u043c\u0430\u0440\u043e\u043a (\u0434\u043b\u044f \u0444\u0438\u043b\u044c\u0442\u0440\u0430 `brand`).","items":{"example":"ford","type":"string"},"type":"array"},"brands":{"description":"\u041c\u0430\u0440\u043a\u0438, \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u043c\u044b\u0435 \u043d\u0430 \u0437\u0430\u0432\u043e\u0434\u0435.","items":{"properties":{"name":{"example":"Ford","type":"string"},"slug":{"description":"Soft-link \u2192 ref_brands.slug (\u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c null).","example":"ford","type":"string"}},"type":"object"},"type":"array"},"city":{"example":"Avon Lake","type":"string"},"coord_precision":{"enum":["exact","city","approx"],"example":"exact","type":"string"},"country":{"example":"United States","type":"string"},"country_iso2":{"description":"ISO 3166-1 alpha-2.","example":"US","type":"string"},"geonameid":{"description":"\u041f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u0439 \u0433\u0435\u043e-\u043a\u043b\u044e\u0447 \u0433\u043e\u0440\u043e\u0434\u0430 \u0437\u0430\u0432\u043e\u0434\u0430 (\u2192 ref_cities / \u0433\u0435\u043e-\u0441\u0435\u0440\u0432\u0438\u0441). \u041c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c null.","example":5160218,"type":"integer"},"id":{"description":"\u0421\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 ID \u0437\u0430\u0432\u043e\u0434\u0430.","example":23,"type":"integer"},"lat":{"example":41.4909,"format":"float","type":"number"},"listings_active":{"description":"\u0422\u043e\u043b\u044c\u043a\u043e \u0432 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0435 `GET /v1/factories/{id}`: \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439 \u0432\u0441\u0435\u0445 \u043c\u043e\u0434\u0435\u043b\u0435\u0439 \u0437\u0430\u0432\u043e\u0434\u0430 \u0441\u0435\u0439\u0447\u0430\u0441 \u0432 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0435 (\u03a3 \u043f\u043e \u043c\u043e\u0434\u0435\u043b\u044f\u043c).","example":3210,"type":"integer"},"lng":{"example":-82.0653,"format":"float","type":"number"},"models":{"description":"\u0422\u043e\u043b\u044c\u043a\u043e \u0432 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0435 `GET /v1/factories/{id}`: \u043c\u043e\u0434\u0435\u043b\u0438 \u0432 \u0442\u0435\u043a\u0443\u0449\u0435\u043c \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0441\u0442\u0432\u0435, \u043e\u0431\u043e\u0433\u0430\u0449\u0451\u043d\u043d\u044b\u0435 \u0436\u0438\u0432\u044b\u043c \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u043e\u043c \u043f\u043e \u043a\u043b\u044e\u0447\u0443 `(brand_slug, model_slug)`.","items":{"properties":{"brand":{"example":"Toyota","type":"string"},"brand_slug":{"example":"toyota","type":"string"},"image":{"description":"\u0420\u0435\u043d\u0434\u0435\u0440 \u043c\u043e\u0434\u0435\u043b\u0438 (mod_model.image_url) \u0438\u043b\u0438 null.","example":"https://modification.gumy.space/...webp","type":"string"},"listings_active":{"description":"\u0410\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439 \u044d\u0442\u043e\u0439 \u043c\u043e\u0434\u0435\u043b\u0438 \u0432 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0435.","example":253,"type":"integer"},"model":{"example":"Camry","type":"string"},"model_slug":{"description":"\u041a\u0430\u043d\u043e\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0439 slug; \u0435\u0441\u043b\u0438 \u0432 \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u0445 \u0434\u0430\u043d\u043d\u044b\u0445 null \u2014 \u0440\u0435\u0437\u043e\u043b\u0432\u0438\u0442\u0441\u044f \u0438\u0437 mod_model \u043f\u043e \u0438\u043c\u0435\u043d\u0438, \u0438\u043d\u0430\u0447\u0435 \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f null.","example":"toyota-camry","type":"string"},"n_modifications":{"description":"\u0427\u0438\u0441\u043b\u043e \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0439 \u043c\u043e\u0434\u0435\u043b\u0438 \u0432 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0435 (modification_spec). 0, \u0435\u0441\u043b\u0438 \u043d\u0435 \u0440\u0435\u0437\u043e\u043b\u0432\u0438\u0442\u0441\u044f.","example":16,"type":"integer"},"price_from_rub":{"description":"\u041c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f total_price_rub \u0441\u0440\u0435\u0434\u0438 \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439 (RUB) \u0438\u043b\u0438 null.","example":2190000,"type":"integer"},"price_to_rub":{"description":"\u041c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f total_price_rub \u0441\u0440\u0435\u0434\u0438 \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439 (RUB) \u0438\u043b\u0438 null.","example":6980000,"type":"integer"},"vehicle_type":{"example":"car","type":"string"}},"type":"object"},"type":"array"},"n_brands":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u043c\u0430\u0440\u043e\u043a \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u0437\u0430\u0432\u043e\u0434\u0435.","example":1,"type":"integer"},"n_models":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u043c\u043e\u0434\u0435\u043b\u0435\u0439 \u0432 \u0442\u0435\u043a\u0443\u0449\u0435\u043c \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0441\u0442\u0432\u0435.","example":5,"type":"integer"},"name":{"example":"Ohio Assembly Plant","type":"string"},"oem_group":{"description":"\u0420\u043e\u0434\u0438\u0442\u0435\u043b\u044c\u0441\u043a\u0430\u044f \u0433\u0440\u0443\u043f\u043f\u0430 (\u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c null).","example":"Toyota Group","type":"string"},"opened_year":{"example":1974,"type":"integer"},"operator":{"description":"\u041e\u043f\u0435\u0440\u0430\u0442\u043e\u0440 / \u0421\u041f.","example":"Ford Motor Company","type":"string"},"region":{"example":"Ohio","type":"string"},"slug":{"description":"\u0421\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 map-\u043a\u043b\u044e\u0447.","example":"toyota-tsutsumi","type":"string"},"vehicle_type":{"enum":["car","motorcycle","both"],"example":"car","type":"string"}},"type":"object"},"FactoryStats":{"description":"\u0410\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u043f\u043e \u0437\u0430\u0432\u043e\u0434\u0430\u043c \u043f\u043e\u0434 \u0442\u0435\u043c \u0436\u0435 \u043d\u0430\u0431\u043e\u0440\u043e\u043c \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432, \u0447\u0442\u043e `GET /v1/factories`. `total_plants` \u0432\u0441\u0435\u0433\u0434\u0430 \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0435\u0442 \u0441 `count` \u0438\u0437 \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0430 \u043f\u0440\u0438 \u0442\u0435\u0445 \u0436\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u0445.","properties":{"by_country":{"description":"\u0420\u0430\u0437\u0431\u0438\u0432\u043a\u0430 \u043f\u043e \u0441\u0442\u0440\u0430\u043d\u0430\u043c, \u043f\u043e \u0443\u0431\u044b\u0432\u0430\u043d\u0438\u044e \u0447\u0438\u0441\u043b\u0430 \u0437\u0430\u0432\u043e\u0434\u043e\u0432.","items":{"properties":{"annual_capacity_units":{"example":17620000,"type":"integer"},"country":{"example":"China","type":"string"},"country_iso2":{"example":"CN","type":"string"},"plants":{"example":52,"type":"integer"}},"type":"object"},"type":"array"},"by_group":{"description":"\u0420\u0430\u0437\u0431\u0438\u0432\u043a\u0430 \u043f\u043e OEM-\u0433\u0440\u0443\u043f\u043f\u0430\u043c (\u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0435\u043f\u0443\u0441\u0442\u044b\u0435), \u043f\u043e \u0443\u0431\u044b\u0432\u0430\u043d\u0438\u044e.","items":{"properties":{"annual_capacity_units":{"example":12000000,"type":"integer"},"oem_group":{"example":"Volkswagen Group","type":"string"},"plants":{"example":65,"type":"integer"}},"type":"object"},"type":"array"},"by_vehicle_type":{"items":{"properties":{"plants":{"example":409,"type":"integer"},"vehicle_type":{"example":"car","type":"string"}},"type":"object"},"type":"array"},"total_annual_capacity_units":{"description":"\u0421\u0443\u043c\u043c\u0430 \u0433\u043e\u0434\u043e\u0432\u044b\u0445 \u043c\u043e\u0449\u043d\u043e\u0441\u0442\u0435\u0439.","example":98347980,"type":"integer"},"total_countries":{"example":47,"type":"integer"},"total_groups":{"description":"\u0427\u0438\u0441\u043b\u043e \u0440\u0430\u0437\u043b\u0438\u0447\u043d\u044b\u0445 \u043d\u0435\u043f\u0443\u0441\u0442\u044b\u0445 `oem_group`.","example":12,"type":"integer"},"total_plants":{"example":414,"type":"integer"}},"type":"object"},"GeoCity":{"description":"\u0413\u043e\u0440\u043e\u0434 \u0438\u0437 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430 GeoNames (cities1000). \u0421\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 \u043a\u043b\u044e\u0447 \u2014 `geonameid` (\u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0443\u0435\u043c \u0445\u0440\u0430\u043d\u0438\u0442\u044c \u0432 \u0441\u0432\u043e\u0435\u0439 \u0411\u0414 \u0438\u043c\u0435\u043d\u043d\u043e \u0435\u0433\u043e, \u0430 \u043d\u0435 \u0441\u0442\u0440\u043e\u043a\u043e\u0432\u043e\u0435 \u0438\u043c\u044f).","properties":{"country_iso2":{"description":"ISO 3166-1 alpha-2.","example":"RU","type":"string"},"feature_code":{"description":"GeoNames feature: PPLC=\u0441\u0442\u043e\u043b\u0438\u0446\u0430, PPLA=\u0430\u0434\u043c\u0438\u043d-\u0446\u0435\u043d\u0442\u0440, PPL=\u0433\u043e\u0440\u043e\u0434, \u2026","example":"PPLC","type":"string"},"geonameid":{"description":"\u0421\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 ID \u0438\u0437 GeoNames.","example":524901,"type":"integer"},"latitude":{"example":55.75222,"format":"float","type":"number"},"longitude":{"example":37.61556,"format":"float","type":"number"},"name":{"description":"\u041b\u043e\u043a\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d\u043d\u043e\u0435 \u0438\u043c\u044f \u043f\u043e `lang`.","example":"\u041c\u043e\u0441\u043a\u0432\u0430","type":"string"},"name_en":{"example":"Moscow","type":"string"},"name_ru":{"example":"\u041c\u043e\u0441\u043a\u0432\u0430","type":"string"},"population":{"example":10381222,"type":"integer"}},"type":"object"},"ParsedFilters":{"description":"\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b, \u0438\u0437\u0432\u043b\u0435\u0447\u0451\u043d\u043d\u044b\u0435 \u0438\u0437 \u0441\u0432\u043e\u0431\u043e\u0434\u043d\u043e\u0433\u043e \u0442\u0435\u043a\u0441\u0442\u0430. \u041f\u043e\u043b\u044f \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u044e\u0442 \u0441 query-\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c\u0438 `/v1/cars` \u2014 \u043e\u0442\u0432\u0435\u0442 \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u043f\u0435\u0440\u0435\u0434\u0430\u0442\u044c \u0432 `/v1/cars`.","properties":{"ambiguity":{"description":"`true`, \u0435\u0441\u043b\u0438 \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u0435\u0441\u0442\u044c \u043d\u0435\u043e\u0434\u043d\u043e\u0437\u043d\u0430\u0447\u043d\u044b\u0435 \u0442\u0435\u0440\u043c\u0438\u043d\u044b (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u00ab\u043d\u0435\u0434\u043e\u0440\u043e\u0433\u043e\u00bb / \u00ab\u043f\u0440\u0435\u043c\u0438\u0443\u043c\u00bb \u0431\u0435\u0437 \u0447\u0438\u0441\u043b\u043e\u0432\u043e\u0433\u043e \u0431\u044e\u0434\u0436\u0435\u0442\u0430).","example":false,"type":"boolean"},"cached":{"description":"`true`, \u0435\u0441\u043b\u0438 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u043f\u043e\u0434\u043d\u044f\u0442 \u0438\u0437 \u043a\u044d\u0448\u0430.","example":false,"type":"boolean"},"currency":{"description":"\u0412\u0430\u043b\u044e\u0442\u0430, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u043b \u0446\u0435\u043d\u044b (\u0432\u0445\u043e\u0434).","example":"RUB","type":"string"},"filters":{"description":"\u0418\u0437\u0432\u043b\u0435\u0447\u0451\u043d\u043d\u044b\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b. \u041f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0442\u0435 \u043a\u043b\u044e\u0447\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0443\u0434\u0430\u043b\u043e\u0441\u044c \u043e\u0434\u043d\u043e\u0437\u043d\u0430\u0447\u043d\u043e \u0432\u044b\u0442\u0430\u0449\u0438\u0442\u044c \u0438\u0437 \u0437\u0430\u043f\u0440\u043e\u0441\u0430. \u0426\u0435\u043d\u044b \u2014 \u0432\u0441\u0435\u0433\u0434\u0430 \u0432 RUB (\u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0430\u0446\u0438\u044f \u043f\u043e `currency` \u0438\u0437 \u0437\u0430\u043f\u0440\u043e\u0441\u0430).","properties":{"availability_type":{"description":"\u00ab\u0412 \u043d\u0430\u043b\u0438\u0447\u0438\u0438\u00bb \u2192 `in_stock`, \u00ab\u043f\u043e\u0434 \u0437\u0430\u043a\u0430\u0437\u00bb \u2192 `to_order`.","enum":["in_stock","to_order"],"example":"in_stock","type":"string"},"body_type":{"description":"\u0422\u0438\u043f \u043a\u0443\u0437\u043e\u0432\u0430. \u041c\u0430\u0441\u0441\u0438\u0432 \u043f\u0440\u0438 \u00ab\u0441\u0435\u0434\u0430\u043d \u0438\u043b\u0438 \u0443\u043d\u0438\u0432\u0435\u0440\u0441\u0430\u043b\u00bb.","example":"\u0421\u0435\u0434\u0430\u043d","type":"string"},"brand":{"description":"\u041c\u0430\u0440\u043a\u0430. \u041c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u043c\u0430\u0441\u0441\u0438\u0432\u043e\u043c \u0441\u0442\u0440\u043e\u043a, \u0435\u0441\u043b\u0438 \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043c\u0430\u0440\u043e\u043a \u0447\u0435\u0440\u0435\u0437 \u00ab\u0438\u043b\u0438\u00bb \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, `\"bmw \u0438\u043b\u0438 kia\"` \u2192 `[\"BMW\", \"Kia\"]`.","example":"Toyota","type":"string"},"city":{"description":"\u0413\u043e\u0440\u043e\u0434 (\u0440\u0443\u0441\u0441\u043a\u043e\u0435 \u0438\u043b\u0438 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0435 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u2014 \u0442\u043e, \u0447\u0442\u043e \u0445\u0440\u0430\u043d\u0438\u0442\u0441\u044f \u0432 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0435). \u042d\u0442\u043e **\u043d\u0435 \u044f\u043a\u043e\u0440\u044c \u0433\u0435\u043e-\u0440\u0430\u0434\u0438\u0443\u0441\u0430** (`near` / `radius_km`), \u0430 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u0444\u0438\u043b\u044c\u0442\u0440 \u0441\u0442\u0440\u043e\u043a\u043e\u0432\u043e\u0433\u043e \u0441\u043e\u0432\u043f\u0430\u0434\u0435\u043d\u0438\u044f \u043f\u043e \u043f\u043e\u043b\u044e `city` \u0432 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0435.","example":"\u041c\u043e\u0441\u043a\u0432\u0430","type":"string"},"color":{"description":"\u0426\u0432\u0435\u0442. \u041c\u0430\u0441\u0441\u0438\u0432 \u043f\u0440\u0438 \u00ab\u043a\u0440\u0430\u0441\u043d\u044b\u0439 \u0438\u043b\u0438 \u0441\u0438\u043d\u0438\u0439\u00bb.","example":"\u0431\u0435\u043b\u044b\u0439","type":"string"},"color_family":{"description":"\u0421\u0435\u043c\u0435\u0439\u0441\u0442\u0432\u043e \u0446\u0432\u0435\u0442\u0430 (warm / cool / neutral / \u2026). \u041f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043a\u043e\u0433\u0434\u0430 \u0432\u0441\u0435 \u0440\u0430\u0441\u043f\u043e\u0437\u043d\u0430\u043d\u043d\u044b\u0435 \u0446\u0432\u0435\u0442\u0430 \u043f\u0440\u0438\u043d\u0430\u0434\u043b\u0435\u0436\u0430\u0442 \u043e\u0434\u043d\u043e\u0439 \u0441\u0435\u043c\u044c\u0435.","example":"warm","type":"string"},"color_id":{"description":"ID \u0446\u0432\u0435\u0442\u0430 \u0432 `ref_colors`. \u041f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0441\u043b\u0438 \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u0440\u043e\u0432\u043d\u043e \u043e\u0434\u0438\u043d \u0446\u0432\u0435\u0442 (\u0431\u0435\u0437 \u00ab\u0438\u043b\u0438\u00bb).","example":5,"type":"integer"},"country":{"description":"\u0421\u0442\u0440\u0430\u043d\u0430. \u041c\u0430\u0441\u0441\u0438\u0432 \u043f\u0440\u0438 \u00ab\u0438\u0437 \u044f\u043f\u043e\u043d\u0438\u0438 \u0438\u043b\u0438 \u043a\u043e\u0440\u0435\u0438\u00bb.","example":"japan","type":"string"},"doors":{"description":"\u0427\u0438\u0441\u043b\u043e \u0434\u0432\u0435\u0440\u0435\u0439 (2..6). \u00ab5-\u0434\u0432\u0435\u0440\u043d\u044b\u0439\u00bb / \u00ab3 \u0434\u0432\u0435\u0440\u0438\u00bb.","example":5,"type":"integer"},"drive_type":{"description":"\u041f\u0440\u0438\u0432\u043e\u0434. \u041c\u0430\u0441\u0441\u0438\u0432 \u043f\u0440\u0438 \u00ab\u043f\u043e\u043b\u043d\u044b\u0439 \u0438\u043b\u0438 \u043f\u0435\u0440\u0435\u0434\u043d\u0438\u0439\u00bb.","example":"\u041f\u043e\u043b\u043d\u044b\u0439","type":"string"},"emission_standard":{"description":"\u042d\u043a\u043e\u043b\u043e\u0433\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442. \u00ab\u0415\u0432\u0440\u043e 5\u00bb / `Euro 6` \u2192 `Euro 5` / `Euro 6`.","example":"Euro 5","type":"string"},"fuel_type":{"description":"\u0422\u043e\u043f\u043b\u0438\u0432\u043e. \u041c\u0430\u0441\u0441\u0438\u0432 \u043f\u0440\u0438 \u00ab\u0431\u0435\u043d\u0437\u0438\u043d \u0438\u043b\u0438 \u0434\u0438\u0437\u0435\u043b\u044c\u00bb.","example":"\u0411\u0435\u043d\u0437\u0438\u043d","type":"string"},"has_accident":{"description":"\u00ab\u0411\u0438\u0442\u044b\u0439\u00bb / \u00ab\u043f\u043e\u0441\u043b\u0435 \u0414\u0422\u041f\u00bb \u2192 `true`. \u00ab\u041d\u0435 \u0431\u0438\u0442\u044b\u0439\u00bb / \u00ab\u0431\u0435\u0437 \u0414\u0422\u041f\u00bb \u2192 `false`.","example":false,"type":"boolean"},"interior_color":{"description":"\u0426\u0432\u0435\u0442 \u0441\u0430\u043b\u043e\u043d\u0430 \u0432 \u043a\u0430\u043d\u043e\u043d\u0438\u0447\u0435\u0441\u043a\u043e\u043c \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u043c (`Black`, `Beige`, `Grey`\u2026). \u0422\u0440\u0438\u0433\u0433\u0435\u0440\u0438\u0442\u0441\u044f \u0441\u043b\u043e\u0432\u0430\u043c\u0438 \u00ab\u0441\u0430\u043b\u043e\u043d / \u0438\u043d\u0442\u0435\u0440\u044c\u0435\u0440 / \u043e\u0431\u0438\u0432\u043a\u0430\u00bb.","example":"Black","type":"string"},"is_leasing":{"description":"`true`, \u0435\u0441\u043b\u0438 \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u0443\u043f\u043e\u043c\u044f\u043d\u0443\u0442 \u00ab\u043b\u0438\u0437\u0438\u043d\u0433\u00bb / `leasing`.","example":true,"type":"boolean"},"is_new":{"example":false,"type":"boolean"},"max_engine":{"example":3.0,"type":"number"},"max_mileage":{"example":100000,"type":"integer"},"max_power":{"example":400,"type":"integer"},"max_price":{"example":3000000,"type":"integer"},"max_year":{"example":2024,"type":"integer"},"min_engine":{"example":1.6,"type":"number"},"min_mileage":{"example":0,"type":"integer"},"min_power":{"example":150,"type":"integer"},"min_price":{"example":1500000,"type":"integer"},"min_year":{"example":2020,"type":"integer"},"model":{"description":"\u041c\u043e\u0434\u0435\u043b\u044c. \u041c\u0430\u0441\u0441\u0438\u0432 \u0441\u0442\u0440\u043e\u043a \u043f\u0440\u0438 \u043f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u0435\u043d\u0438\u0438 \u0447\u0435\u0440\u0435\u0437 \u00ab\u0438\u043b\u0438\u00bb (`\"x5 \u0438\u043b\u0438 x3\"` \u2192 `[\"X5\", \"X3\"]`).","example":"Camry","type":"string"},"near":{"description":"\u042f\u043a\u043e\u0440\u044c \u0442\u043e\u0447\u043a\u0438 \u043f\u043e\u0438\u0441\u043a\u0430. `\"@me\"` \u2014 \u043a\u043b\u0438\u0435\u043d\u0442 \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u043d\u0443\u044e \u0433\u0435\u043e\u043b\u043e\u043a\u0430\u0446\u0438\u044e, \u0438\u043d\u0430\u0447\u0435 `\"<lat>,<lng>\"` (\u0434\u0435\u0441\u044f\u0442\u0438\u0447\u043d\u044b\u0435 \u0433\u0440\u0430\u0434\u0443\u0441\u044b \u0447\u0435\u0440\u0435\u0437 \u0437\u0430\u043f\u044f\u0442\u0443\u044e). \u041f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0432 \u043f\u0430\u0440\u0435 \u0441 `radius_km`.","example":"55.755864,37.617698","type":"string"},"owner_count":{"description":"\u0427\u0438\u0441\u043b\u043e \u0432\u043b\u0430\u0434\u0435\u043b\u044c\u0446\u0435\u0432 (0..9). \u00ab\u041e\u0434\u0438\u043d \u0432\u043b\u0430\u0434\u0435\u043b\u0435\u0446\u00bb / \u00ab\u043f\u0435\u0440\u0432\u044b\u0439 \u0445\u043e\u0437\u044f\u0438\u043d\u00bb \u2192 `1`.","example":1,"type":"integer"},"profitability":{"description":"\u041c\u0430\u0440\u043a\u0435\u0440 \u0432\u044b\u0433\u043e\u0434\u043d\u043e\u0441\u0442\u0438. \u00ab\u0412\u044b\u0433\u043e\u0434\u043d\u044b\u0435\u00bb \u2192 `profitable`, \u00ab\u043f\u0435\u0440\u0435\u043e\u0446\u0435\u043d\u0451\u043d\u043d\u044b\u0435\u00bb \u2192 `unprofitable`.","enum":["profitable","neutral","unprofitable"],"example":"profitable","type":"string"},"radius_km":{"description":"\u0420\u0430\u0434\u0438\u0443\u0441 \u0432 \u043a\u0438\u043b\u043e\u043c\u0435\u0442\u0440\u0430\u0445 (>0, \u226420015). \u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `50` \u0434\u043b\u044f NL-\u0444\u0440\u0430\u0437 \u0432\u0438\u0434\u0430 \u00ab\u0440\u044f\u0434\u043e\u043c \u0441 \u2026\u00bb / \u00abnear \u2026\u00bb \u0431\u0435\u0437 \u044f\u0432\u043d\u043e\u0433\u043e \u0447\u0438\u0441\u043b\u0430. \u041f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0432 \u043f\u0430\u0440\u0435 \u0441 `near`.","example":50,"type":"number"},"seats":{"description":"\u0427\u0438\u0441\u043b\u043e \u043c\u0435\u0441\u0442 (1..9). \u00ab\u0421\u0435\u043c\u0438\u043c\u0435\u0441\u0442\u043d\u044b\u0439\u00bb / \u00ab5 \u043c\u0435\u0441\u0442\u00bb.","example":7,"type":"integer"},"seller_type":{"description":"\u0422\u0438\u043f \u043f\u0440\u043e\u0434\u0430\u0432\u0446\u0430. \u00ab\u041e\u0442 \u0434\u0438\u043b\u0435\u0440\u0430\u00bb \u2192 `dealer`, \u00ab\u0447\u0430\u0441\u0442\u043d\u0438\u043a\u00bb \u2192 `private`.","enum":["dealer","private","leasing"],"example":"dealer","type":"string"},"steering_side":{"description":"\u0421\u0442\u043e\u0440\u043e\u043d\u0430 \u0440\u0443\u043b\u044f. \u00ab\u041f\u0440\u0430\u0432\u044b\u0439 \u0440\u0443\u043b\u044c\u00bb / RHD \u2192 `right`.","enum":["left","right"],"example":"right","type":"string"},"transmission":{"description":"\u041a\u043e\u0440\u043e\u0431\u043a\u0430. \u041c\u0430\u0441\u0441\u0438\u0432 \u043f\u0440\u0438 \u00ab\u0430\u0432\u0442\u043e\u043c\u0430\u0442 \u0438\u043b\u0438 \u0440\u043e\u0431\u043e\u0442\u00bb.","example":"\u0410\u0432\u0442\u043e\u043c\u0430\u0442","type":"string"},"vehicle_type":{"example":"car","type":"string"}},"type":"object"},"missing":{"description":"\u0421\u043f\u0438\u0441\u043e\u043a \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0443\u043f\u043e\u043c\u044f\u043d\u0443\u0442\u044b \u043d\u0435\u044f\u0432\u043d\u043e, \u043d\u043e \u0442\u0440\u0435\u0431\u0443\u044e\u0442 \u0443\u0442\u043e\u0447\u043d\u0435\u043d\u0438\u044f \u0443 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f. \u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440: `[\"price\"]` \u2014 \u043a\u043e\u0433\u0434\u0430 \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u0435\u0441\u0442\u044c \u00ab\u043d\u0435\u0434\u043e\u0440\u043e\u0433\u043e\u00bb, \u043d\u043e \u043d\u0435\u0442 \u0447\u0438\u0441\u043b\u0430.","example":[],"items":{"type":"string"},"type":"array"},"mode":{"description":"\u0420\u0435\u0436\u0438\u043c \u043f\u0430\u0440\u0441\u0438\u043d\u0433\u0430, \u0441 \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u0431\u044b\u043b \u0441\u0434\u0435\u043b\u0430\u043d \u0437\u0430\u043f\u0440\u043e\u0441.","enum":["fast","auto","quality"],"example":"auto","type":"string"}},"type":"object"}},"host":"api.proride.io","info":{"contact":{"name":"ProRide","url":"https://proride.io"},"description":"\u041f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0439 REST API \u0434\u043b\u044f \u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0441 AI-\u0430\u0433\u0435\u043d\u0442\u043e\u043c \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430 \u0430\u0432\u0442\u043e\u043c\u043e\u0431\u0438\u043b\u0435\u0439 **proride.io** \u2014 \u0442\u043e\u0442 \u0436\u0435 \u0434\u0432\u0438\u0436\u043e\u043a, \u0447\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0432 \u0432\u0438\u0434\u0436\u0435\u0442\u0435 `widget.proride.io`.\n\n\u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0438\u0437 \u0441\u0442\u043e\u0440\u043e\u043d\u043d\u0438\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432:\n- \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0442\u044c \u0441\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u044b AI-\u0430\u0433\u0435\u043d\u0442\u0443 (\u0440\u0443\u0441\u0441\u043a\u0438\u0439 / \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u0438\u0439 / \u0438 \u0434\u0440.);\n- \u043f\u043e\u043b\u0443\u0447\u0430\u0442\u044c \u0432 \u043e\u0442\u0432\u0435\u0442 \u0442\u0435\u043a\u0441\u0442 \u0430\u0433\u0435\u043d\u0442\u0430 \u0438 \u043c\u0430\u0441\u0441\u0438\u0432 \u043a\u0430\u0440\u0442\u043e\u0447\u0435\u043a \u0430\u0432\u0442\u043e\u043c\u043e\u0431\u0438\u043b\u0435\u0439 \u0441 \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u044f\u043c\u0438 (`img_main`, `gallery`), \u0446\u0435\u043d\u043e\u0439, \u0445\u0430\u0440\u0430\u043a\u0442\u0435\u0440\u0438\u0441\u0442\u0438\u043a\u0430\u043c\u0438 \u0438 \u0441\u0441\u044b\u043b\u043a\u043e\u0439 \u043d\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0443 \u0430\u0432\u0442\u043e;\n- \u0438\u0441\u043a\u0430\u0442\u044c \u043f\u043e \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0443 \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e (\u0431\u0440\u0435\u043d\u0434, \u043c\u043e\u0434\u0435\u043b\u044c, \u0431\u044e\u0434\u0436\u0435\u0442, \u0442\u0438\u043f \u043a\u0443\u0437\u043e\u0432\u0430 \u0438 \u0442. \u0434.);\n- \u043f\u043e\u043b\u0443\u0447\u0430\u0442\u044c \u0441\u043f\u0438\u0441\u043e\u043a \u0431\u0440\u0435\u043d\u0434\u043e\u0432 \u0438 \u043c\u043e\u0434\u0435\u043b\u0435\u0439.\n\n### \u0410\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u044f\n\u041f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0439\u0442\u0435 \u043a\u043b\u044e\u0447 \u0432 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0435 `X-API-Key`. \u041a\u043b\u044e\u0447 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0443 \u0430\u0434\u043c\u0438\u043d\u0438\u0441\u0442\u0440\u0430\u0442\u043e\u0440\u0430.","title":"ProRide AI Agent API","version":"1.0.0"},"paths":{"/health":{"get":{"responses":{"200":{"description":"OK","schema":{"properties":{"service":{"example":"ymai-api","type":"string"},"status":{"example":"ok","type":"string"}},"type":"object"}}},"security":[],"summary":"Health check","tags":["system"]}},"/v1/cars":{"get":{"description":"\u0415\u0441\u043b\u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u043d `search`, \u0441\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0439 \u0442\u0435\u043a\u0441\u0442 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 \u0444\u0438\u043b\u044c\u0442\u0440\u044b\n(\u0442\u043e\u0442 \u0436\u0435 \u043f\u0430\u0440\u0441\u0435\u0440, \u0447\u0442\u043e \u0432 `/v1/search/parse`). \u042f\u0432\u043d\u044b\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b\n(`brand`, `min_price`, ...) \u043f\u0435\u0440\u0435\u043a\u0440\u044b\u0432\u0430\u044e\u0442 \u0442\u043e, \u0447\u0442\u043e \u0438\u0437\u0432\u043b\u0435\u0447\u0435\u043d\u043e \u0438\u0437 \u0442\u0435\u043a\u0441\u0442\u0430.\n","parameters":[{"description":"\u0421\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0439 \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441","in":"query","name":"search","type":"string"},{"in":"query","name":"brand","type":"string"},{"in":"query","name":"model","type":"string"},{"default":"car","in":"query","name":"vehicle_type","type":"string"},{"in":"query","name":"body_type","type":"string"},{"in":"query","name":"fuel_type","type":"string"},{"in":"query","name":"transmission","type":"string"},{"in":"query","name":"drive_type","type":"string"},{"in":"query","name":"country","type":"string"},{"in":"query","name":"color","type":"string"},{"in":"query","name":"min_price","type":"integer"},{"in":"query","name":"max_price","type":"integer"},{"in":"query","name":"min_year","type":"integer"},{"in":"query","name":"max_year","type":"integer"},{"in":"query","name":"min_mileage","type":"integer"},{"in":"query","name":"max_mileage","type":"integer"},{"in":"query","name":"min_power","type":"integer"},{"in":"query","name":"max_power","type":"integer"},{"in":"query","name":"min_engine","type":"number"},{"in":"query","name":"max_engine","type":"number"},{"enum":[0,1],"in":"query","name":"is_new","type":"integer"},{"default":"ru","description":"\u042f\u0437\u044b\u043a \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u043c\u044b\u0445 \u043f\u043e\u043b\u0435\u0439 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438. \u041b\u043e\u043a\u0430\u043b\u0438\u0437\u0443\u044e\u0442\u0441\u044f `fuel_type`, `transmission`, `drive_type`, `body_type`, `color`, `country_name`, `vehicle_type_name` (\u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u2014 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a\u0438 `ref_*`). \u0421\u044b\u0440\u044b\u0435 \u043a\u043e\u0434\u044b (`country`, `vehicle_type`, `seller_type`, `steering_side`) \u043d\u0435 \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u044f\u0442\u0441\u044f. \u041a\u043e\u0434 \u043f\u043e ISO-639 \u0438\u0437 `/v1/languages` (`ru`, `en`, `zh-CN`, `de`, \u2026; \u0440\u0435\u0433\u0438\u0441\u0442\u0440 \u043d\u0435 \u0432\u0430\u0436\u0435\u043d). \u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `ru` \u2014 \u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435 \u0431\u0435\u0437 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0439. \u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u043a\u043e\u0434 \u0442\u0440\u0430\u043a\u0442\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a `ru`. \u041d\u0435\u0442 \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u0430 \u2014 \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442\u0441\u044f \u0440\u0443\u0441\u0441\u043a\u043e\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435.\n","example":"en","in":"query","name":"lang","type":"string"},{"default":"RUB","description":"\u0412\u0430\u043b\u044e\u0442\u0430 \u0446\u0435\u043d \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438. \u041a\u0430\u043d\u043e\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0435 \u0440\u0443\u0431\u043b\u0451\u0432\u044b\u0435 \u043f\u043e\u043b\u044f (`total_price_rub`, `price_rub`, `price_breakdown.*_rub`) **\u043d\u0435 \u043c\u0435\u043d\u044f\u044e\u0442\u0441\u044f** \u2014 \u0440\u0443\u0431\u043b\u044c \u044d\u0442\u043e \u0445\u0440\u0430\u043d\u0438\u043c\u0430\u044f \u043f\u0440\u0430\u0432\u0434\u0430. \u041f\u0440\u0438 `currency != RUB` \u043a \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0430\u0434\u0434\u0438\u0442\u0438\u0432\u043d\u044b\u0439 \u0431\u043b\u043e\u043a `price_converted` \u0441 \u0442\u0435\u043c\u0438 \u0436\u0435 \u0446\u0435\u043d\u0430\u043c\u0438, \u043f\u0435\u0440\u0435\u0432\u0435\u0434\u0451\u043d\u043d\u044b\u043c\u0438 \u043f\u043e \u0444\u0438\u043a\u0441\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u043c\u0443 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u043e\u043c\u0443 \u043a\u0443\u0440\u0441\u0443 (`USD`, `EUR`, `CNY`, `KZT`, `BYN`, `GBP`; \u0440\u0435\u0433\u0438\u0441\u0442\u0440 \u043d\u0435 \u0432\u0430\u0436\u0435\u043d). \u041a\u0443\u0440\u0441 \u043f\u0443\u0431\u043b\u0438\u043a\u0443\u0435\u0442\u0441\u044f \u0432 \u043a\u0430\u0436\u0434\u043e\u043c \u0431\u043b\u043e\u043a\u0435 (`rate` \u2014 \u0440\u0443\u0431\u043b\u0435\u0439 \u0437\u0430 1 \u0435\u0434\u0438\u043d\u0438\u0446\u0443 \u0432\u0430\u043b\u044e\u0442\u044b), \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f = `round(<rub> / rate)`. \u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `RUB` \u2014 \u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435 \u0431\u0435\u0437 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0439 (\u0431\u043b\u043e\u043a \u043d\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f). \u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u043a\u043e\u0434 \u0442\u0440\u0430\u043a\u0442\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a `RUB`.\n","example":"USD","in":"query","name":"currency","type":"string"},{"description":"\u0424\u0438\u043b\u044c\u0442\u0440 \u043f\u043e FK \u043d\u0430 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0439 (`modification.gumy.space`). \u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u0441 \u044d\u0442\u0438\u043c `modification_id`. \u0421\u043c. ADR-0028.\n","example":79221,"in":"query","name":"modification_id","type":"integer"},{"description":"\u0422\u043e \u0436\u0435, \u0447\u0442\u043e `modification_id`, \u043d\u043e \u043c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u2014 CSV \u0438\u043b\u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u0435\u043d\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 (`?modification_ids=1&modification_ids=2`).\n","example":"79221,67234,29196","in":"query","name":"modification_ids","type":"string"},{"default":"appeal_score","description":"\u041f\u043e\u043b\u0435 \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043a\u0438 (\u0442\u043e\u0442 \u0436\u0435 \u043d\u0430\u0431\u043e\u0440 \u0438\u043c\u0451\u043d, \u0447\u0442\u043e \u0432 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0435 ai-auto.tech \u0438 maps.proride.io \u2014 `?sort=\u2026&order=\u2026` \u043f\u0435\u0440\u0435\u043d\u043e\u0441\u0438\u0442\u0441\u044f \u043c\u0435\u0436\u0434\u0443 \u0441\u0430\u0439\u0442\u0430\u043c\u0438 \u0431\u0435\u0437 \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u0430). \u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `appeal_score` \u2014 \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0439 \u0440\u0435\u0439\u0442\u0438\u043d\u0433 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f (\u0443\u0447\u0438\u0442\u044b\u0432\u0430\u0435\u0442 \u0441\u0432\u0435\u0436\u0435\u0441\u0442\u044c, \u043f\u043e\u043b\u043d\u043e\u0442\u0443 \u0434\u0430\u043d\u043d\u044b\u0445, \u0444\u043e\u0442\u043e). `profit` \u2014 \u0441\u0430\u043c\u044b\u0435 \u0432\u044b\u0433\u043e\u0434\u043d\u044b\u0435 \u0441\u0434\u0435\u043b\u043a\u0438 (\u043d\u0438\u0436\u0435 \u0440\u044b\u043d\u043e\u0447\u043d\u043e\u0439 \u0446\u0435\u043d\u044b). \u0414\u043b\u044f \u043a\u043b\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043a\u043e\u0439 \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043a\u0438 \u043f\u043e \u0446\u0435\u043d\u0435 \u044f\u0432\u043d\u043e \u043f\u0435\u0440\u0435\u0434\u0430\u0439\u0442\u0435 `sort=total_price_rub&order=ASC`. **\u0410\u043b\u0438\u0430\u0441\u044b (\u043a\u0430\u043a \u0432 `/v1/cars/grouped`):** `price_asc` = `total_price_rub`+`ASC`, `price_desc` = `total_price_rub`+`DESC`, `year_desc` = `year`+`DESC` \u2014 \u0430\u043b\u0438\u0430\u0441 \u0441\u0430\u043c \u0437\u0430\u0434\u0430\u0451\u0442 `order`. \u0421\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043a\u0430 \u0443\u0441\u0442\u043e\u0439\u0447\u0438\u0432\u0430 \u043c\u0435\u0436\u0434\u0443 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430\u043c\u0438 (\u0432\u0442\u043e\u0440\u0438\u0447\u043d\u044b\u0439 \u043a\u043b\u044e\u0447 `id`), \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043a\u043b\u0438\u0435\u043d\u0442\u0443 **\u043d\u0435 \u043d\u0443\u0436\u043d\u043e** \u043f\u0435\u0440\u0435-\u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u043b\u0438 \u0434\u0435\u0434\u0443\u043f\u0438\u0442\u044c \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b. \u0410\u043b\u0438\u0430\u0441 `total_score` \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0434\u043b\u044f \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438 \u0438 \u044d\u043a\u0432\u0438\u0432\u0430\u043b\u0435\u043d\u0442\u0435\u043d `appeal_score`. \u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u043e\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u0442\u0438\u0445\u043e \u043e\u0442\u043a\u0430\u0442\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043d\u0430 `appeal_score`.\n","enum":["appeal_score","profit","total_price_rub","year","mileage","created_at","price","price_asc","price_desc","year_desc"],"in":"query","name":"sort","type":"string"},{"default":"DESC","enum":["ASC","DESC"],"in":"query","name":"order","type":"string"},{"default":1,"in":"query","name":"page","type":"integer"},{"default":8,"in":"query","maximum":500,"name":"per_page","type":"integer"},{"description":"\u042f\u043a\u043e\u0440\u044c \u0433\u0435\u043e-\u0440\u0430\u0434\u0438\u0443\u0441\u0430: `\"<lat>,<lng>\"` (\u0434\u0435\u0441\u044f\u0442\u0438\u0447\u043d\u044b\u0435 \u0433\u0440\u0430\u0434\u0443\u0441\u044b \u0447\u0435\u0440\u0435\u0437 \u0437\u0430\u043f\u044f\u0442\u0443\u044e). \u041f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c \u0432 \u043f\u0430\u0440\u0435 \u0441 `radius_km`. `\"@me\"` \u043d\u0435 \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f \u2014 \u043a\u043b\u0438\u0435\u043d\u0442 \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0441\u0430\u043c.\n","example":"55.755864,37.617698","in":"query","name":"near","type":"string"},{"description":"\u0420\u0430\u0434\u0438\u0443\u0441 \u043f\u043e\u0438\u0441\u043a\u0430 \u0432 \u043a\u0438\u043b\u043e\u043c\u0435\u0442\u0440\u0430\u0445. \u041f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c \u0432 \u043f\u0430\u0440\u0435 \u0441 `near`. \u0413\u0435\u043e\u0444\u0438\u043b\u044c\u0442\u0440 \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u043e \u0446\u0435\u043d\u0442\u0440\u043e\u0438\u0434\u0430\u043c \u0433\u043e\u0440\u043e\u0434\u043e\u0432 (`ref_cities`).\n","example":50,"in":"query","maximum":20015,"minimum":0.1,"name":"radius_km","type":"number"},{"description":"UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438-\u0434\u0438\u043b\u0435\u0440\u0430. \u0415\u0441\u043b\u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u043d, \u043f\u043e\u0438\u0441\u043a \u0438\u0434\u0451\u0442 \u043f\u043e `frontend.cars_for_company(<uuid>)` \u2014 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0443, \u043e\u0442\u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u043c\u0443 \u0441\u043e\u0445\u0440\u0430\u043d\u0451\u043d\u043d\u044b\u043c\u0438 `car_filters` \u0434\u0438\u043b\u0435\u0440\u0430. \u0411\u0435\u0437 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 \u2014 \u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u044b\u0439 \u043a\u0430\u0442\u0430\u043b\u043e\u0433. \u041d\u0435\u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0439 / \u043d\u0435\u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439 UUID \u043c\u043e\u043b\u0447\u0430 \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f (\u043f\u043e\u0438\u0441\u043a \u0438\u0434\u0451\u0442 \u043f\u043e \u043f\u043e\u043b\u043d\u043e\u043c\u0443 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0443).\n","in":"query","name":"company_id","type":"string"}],"responses":{"200":{"description":"\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b \u043f\u043e\u0438\u0441\u043a\u0430. \u041a\u043e\u043d\u0432\u0435\u0440\u0442 \u0441\u043f\u0438\u0441\u043a\u0430 **\u0444\u0438\u043a\u0441\u0438\u0440\u043e\u0432\u0430\u043d \u0438 \u0435\u0434\u0438\u043d\u044b\u0439** \u0441 `POST /v1/chat`: \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u0432\u0441\u0435\u0433\u0434\u0430 \u043f\u043e\u0434 \u043a\u043b\u044e\u0447\u043e\u043c `cars`, \u043e\u0431\u0449\u0435\u0435 \u0447\u0438\u0441\u043b\u043e \u2014 \u043f\u043e\u0434 `total`, \u043f\u043b\u044e\u0441 `offset`/`limit`/`has_more` \u0434\u043b\u044f \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438 \u00ab\u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0435\u0449\u0451\u00bb. \u041d\u0435 \u043d\u0443\u0436\u043d\u043e \u0443\u0433\u0430\u0434\u044b\u0432\u0430\u0442\u044c \u0444\u043e\u0440\u043c\u0443 \u043e\u0442\u0432\u0435\u0442\u0430 \u2014 \u043e\u043d\u0430 \u043e\u0434\u043d\u0430.\n","schema":{"properties":{"cars":{"description":"\u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u0430\u0432\u0442\u043e. \u041a\u0430\u0436\u0434\u0430\u044f \u043d\u0435\u0441\u0451\u0442 `latitude`/`longitude` (\u0446\u0435\u043d\u0442\u0440\u043e\u0438\u0434 \u0433\u043e\u0440\u043e\u0434\u0430 \u0438\u0437 `ref_cities`, \u043b\u0438\u0431\u043e \u043e\u0431\u0435 `null`) \u2014 \u043a\u0430\u0440\u0442\u0443 \u043c\u043e\u0436\u043d\u043e \u0440\u0438\u0441\u043e\u0432\u0430\u0442\u044c \u0431\u0435\u0437 \u0441\u0432\u043e\u0435\u0439 \u0442\u0430\u0431\u043b\u0438\u0446\u044b \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442 \u0433\u043e\u0440\u043e\u0434\u043e\u0432.","items":{"$ref":"#/definitions/Car"},"type":"array"},"color_note":{"description":"\u0417\u0430\u043c\u0435\u0442\u043a\u0430, \u0435\u0441\u043b\u0438 \u0444\u0438\u043b\u044c\u0442\u0440 \u0446\u0432\u0435\u0442\u0430 \u0431\u044b\u043b \u0441\u043d\u044f\u0442 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438","type":"string"},"company_id":{"description":"\u042d\u0445\u043e `company_id` \u0438\u0437 \u0437\u0430\u043f\u0440\u043e\u0441\u0430. `null` \u0432 \u0432\u0438\u0442\u0440\u0438\u043d\u043d\u043e\u043c \u0440\u0435\u0436\u0438\u043c\u0435.","format":"uuid","type":"string"},"contacts":{"$ref":"#/definitions/Car/properties/contacts"},"currency":{"description":"\u042d\u0445\u043e \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043d\u043d\u043e\u0439 \u0432\u0430\u043b\u044e\u0442\u044b \u0432\u044b\u0434\u0430\u0447\u0438 (\u0441\u043c. \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 `currency`). \u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u043a\u043e\u0434 \u2192 `RUB`.","example":"USD","type":"string"},"has_more":{"description":"\u0415\u0441\u0442\u044c \u043b\u0438 \u0435\u0449\u0451 \u0437\u0430 \u0442\u0435\u043a\u0443\u0449\u0435\u0439 \u043f\u0430\u0447\u043a\u043e\u0439. \u0414\u043b\u044f \u00ab\u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0435\u0449\u0451\u00bb \u0433\u0440\u0443\u0437\u0438\u0442\u0435 \u0441\u043e \u0441\u043c\u0435\u0449\u0435\u043d\u0438\u0435\u043c `offset + limit`, \u043f\u043e\u043a\u0430 `has_more=true`.","type":"boolean"},"lang":{"description":"\u042d\u0445\u043e \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043d\u043d\u043e\u0433\u043e \u044f\u0437\u044b\u043a\u0430 \u0432\u044b\u0434\u0430\u0447\u0438 (\u0441\u043c. \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 `lang`). \u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u043a\u043e\u0434 \u2192 `ru`.","example":"en","type":"string"},"limit":{"description":"\u0420\u0430\u0437\u043c\u0435\u0440 \u043f\u0430\u0447\u043a\u0438 (= `per_page`).","type":"integer"},"offset":{"description":"\u0421\u043c\u0435\u0449\u0435\u043d\u0438\u0435 \u0442\u0435\u043a\u0443\u0449\u0435\u0439 \u043f\u0430\u0447\u043a\u0438 \u0432 \u043e\u0431\u0449\u0435\u043c \u043d\u0430\u0431\u043e\u0440\u0435.","type":"integer"},"page":{"description":"\u0422\u0435\u043a\u0443\u0449\u0430\u044f \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430 (1-based).","type":"integer"},"total":{"description":"\u0412\u0441\u0435\u0433\u043e \u043d\u0430\u0439\u0434\u0435\u043d\u043e \u043f\u043e \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u043c (\u0447\u0438\u0441\u043b\u043e \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u043e\u0432).","type":"integer"},"total_pages":{"description":"\u0427\u0438\u0441\u043b\u043e \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u043f\u0440\u0438 `per_page` (\u0434\u043b\u044f page-based \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438).","type":"integer"}},"type":"object"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041f\u043e\u0438\u0441\u043a \u0430\u0432\u0442\u043e\u043c\u043e\u0431\u0438\u043b\u0435\u0439 \u043f\u043e \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0443","tags":["catalog"]}},"/v1/cars-geo":{"get":{"description":"\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0432\u0441\u0435 \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0435 \u0430\u0432\u0442\u043e, \u0441\u0433\u0440\u0443\u043f\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043f\u043e \u0442\u043e\u0447\u043d\u043e\u043c\u0443 (lat, lng)\n\u0446\u0435\u043d\u0442\u0440\u043e\u0438\u0434\u0430 \u0433\u043e\u0440\u043e\u0434\u0430 (`ref_cities`). \u041e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u043d\u0430\u0431\u043e\u0440 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432\n\u043f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u0437\u0434\u0435\u0441\u044c \u0438 \u0432 `/v1/cars` \u2014 \u043a\u0430\u0440\u0442\u0430 \u0438 \u0441\u043f\u0438\u0441\u043e\u043a \u00ab\u0438\u0434\u0443\u0442 \u0432 \u043d\u043e\u0433\u0443\u00bb.\n\n\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 \u0434\u043b\u044f \u043e\u0442\u0440\u0438\u0441\u043e\u0432\u043a\u0438 \u043c\u0430\u0440\u043a\u0435\u0440\u043e\u0432 \u043d\u0430 \u043a\u0430\u0440\u0442\u0435 (Yandex / Leaflet /\nMapbox). \u041d\u0430 \u043a\u0430\u0436\u0434\u043e\u0439 \u0442\u043e\u0447\u043a\u0435 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f:\n\n- `lat`, `lng` \u2014 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0446\u0435\u043d\u0442\u0440\u043e\u0438\u0434\u0430 \u0433\u043e\u0440\u043e\u0434\u0430;\n- `cnt` \u2014 \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0430\u0432\u0442\u043e \u0432 \u044d\u0442\u043e\u0439 \u0442\u043e\u0447\u043a\u0435 (\u0434\u043b\u044f \u0431\u044d\u0439\u0434\u0436\u0430 \u00ab12\u00bb);\n- `city`, `country` \u2014 \u043f\u043e\u0434\u043f\u0438\u0441\u044c (\u0440\u0430\u043d\u0434\u043e\u043c\u043d\u043e\u0435 \u0438\u0437 \u0433\u0440\u0443\u043f\u043f\u044b);\n- `min_price_rub` \u2014 \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f \u0446\u0435\u043d\u0430 \u0432 \u0433\u0440\u0443\u043f\u043f\u0435 (\u0434\u043b\u044f \u043f\u043e\u0434\u043f\u0438\u0441\u0438 \u00ab\u043e\u0442 1.2\u041c\u00bb).\n\n\u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 **\u0442\u0435 \u0436\u0435** \u0444\u0438\u043b\u044c\u0442\u0440\u044b, \u0447\u0442\u043e \u0438 `/v1/cars` (\u0432\u043a\u043b\u044e\u0447\u0430\u044f `near` +\n`radius_km` \u2014 \u0442\u043e\u0447\u043a\u0430-\u0440\u0430\u0434\u0438\u0443\u0441). \u041a\u044d\u0448 \u043e\u0442\u0432\u0435\u0442\u0430 ~60 \u0441.\n\n\u0417\u0430\u043c\u0435\u043d\u044f\u0435\u0442 `maps.proride.io/api/cars-geo` \u2014 \u043e\u0434\u0438\u043d \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043f\u0440\u0430\u0432\u0434\u044b.\n","parameters":[{"description":"\u0421\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0439 \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 (\u0442\u043e\u0442 \u0436\u0435 \u043f\u0430\u0440\u0441\u0435\u0440, \u0447\u0442\u043e \u0432 /v1/search/parse)","in":"query","name":"search","type":"string"},{"in":"query","name":"brand","type":"string"},{"in":"query","name":"model","type":"string"},{"default":"car","in":"query","name":"vehicle_type","type":"string"},{"in":"query","name":"body_type","type":"string"},{"in":"query","name":"fuel_type","type":"string"},{"in":"query","name":"transmission","type":"string"},{"in":"query","name":"drive_type","type":"string"},{"in":"query","name":"country","type":"string"},{"in":"query","name":"color","type":"string"},{"in":"query","name":"min_price","type":"integer"},{"in":"query","name":"max_price","type":"integer"},{"in":"query","name":"min_year","type":"integer"},{"in":"query","name":"max_year","type":"integer"},{"in":"query","name":"min_mileage","type":"integer"},{"in":"query","name":"max_mileage","type":"integer"},{"enum":[0,1],"in":"query","name":"is_new","type":"integer"},{"description":"\u042f\u043a\u043e\u0440\u044c \u0442\u043e\u0447\u043a\u0438 \u0432 \u0444\u043e\u0440\u043c\u0430\u0442\u0435 `<lat>,<lng>` (\u0434\u0435\u0441\u044f\u0442\u0438\u0447\u043d\u044b\u0435 \u0433\u0440\u0430\u0434\u0443\u0441\u044b \u0447\u0435\u0440\u0435\u0437 \u0437\u0430\u043f\u044f\u0442\u0443\u044e). \u041f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c \u0432 \u043f\u0430\u0440\u0435 \u0441 `radius_km`.\n","example":"55.755864,37.617698","in":"query","name":"near","type":"string"},{"description":"\u0420\u0430\u0434\u0438\u0443\u0441 \u0432 \u043a\u043c. \u0411\u0435\u0437 `near` \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f.\n","example":50,"in":"query","name":"radius_km","type":"number"},{"description":"UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438-\u0434\u0438\u043b\u0435\u0440\u0430 (\u0444\u0438\u043b\u044c\u0442\u0440 \u043f\u043e `frontend.cars_for_company`)","in":"query","name":"company_id","type":"string"}],"responses":{"200":{"description":"\u0421\u0433\u0440\u0443\u043f\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0442\u043e\u0447\u043a\u0438 \u043d\u0430 \u043a\u0430\u0440\u0442\u0443","schema":{"properties":{"groups":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u0443\u043d\u0438\u043a\u0430\u043b\u044c\u043d\u044b\u0445 \u0442\u043e\u0447\u0435\u043a","example":124,"type":"integer"},"points":{"items":{"properties":{"city":{"example":"\u041c\u043e\u0441\u043a\u0432\u0430","type":"string"},"cnt":{"example":42,"type":"integer"},"country":{"example":"russia","type":"string"},"lat":{"example":55.755864,"type":"number"},"lng":{"example":37.617698,"type":"number"},"min_price_rub":{"example":1200000,"type":"number"}},"type":"object"},"type":"array"},"total":{"description":"\u0421\u0443\u043c\u043c\u0430 cnt \u043f\u043e \u0432\u0441\u0435\u043c \u0442\u043e\u0447\u043a\u0430\u043c (= \u0432\u0441\u0435\u0433\u043e \u0430\u0432\u0442\u043e \u043f\u043e\u0434 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u043c)","example":8721,"type":"integer"}},"type":"object"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041a\u043b\u0430\u0441\u0442\u0435\u0440\u0438\u0437\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0442\u043e\u0447\u043a\u0438 \u043d\u0430 \u043a\u0430\u0440\u0442\u0443","tags":["catalog"]}},"/v1/cars/grouped":{"get":{"description":"\u0412\u0438\u0442\u0440\u0438\u043d\u0430 \u00ab\u041a\u0430\u0442\u0430\u043b\u043e\u0433\u00bb \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u043e\u0434\u043d\u0443 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0443 \u043d\u0430 \u041c\u041e\u0414\u0415\u041b\u042c (`brand`+`model`):\n\u0432\u043d\u0443\u0442\u0440\u0438 \u2014 \u0446\u0432\u0435\u0442\u043e\u0432\u044b\u0435 \u0441\u0432\u043e\u0442\u0447\u0438, \u00ab\u043e\u0442 {\u0446\u0435\u043d\u0430}\u00bb, \u00abN \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u043e\u0432\u00bb. \u042d\u0442\u043e\u0442 \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442\n\u043e\u0442\u0434\u0430\u0451\u0442 \u0443\u0436\u0435 \u0441\u0433\u0440\u0443\u043f\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435 \u2014 \u043a\u0430\u043d\u0430\u043b \u043d\u0435 \u0441\u0445\u043b\u043e\u043f\u044b\u0432\u0430\u0435\u0442 \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0438 \u0441\u0430\u043c.\n\n\u0412\u0445\u043e\u0434 \u2014 **\u0442\u0435 \u0436\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b**, \u0447\u0442\u043e \u0443 `GET /v1/cars` (`brand`, `model`,\n`vehicle_type`, `min_price`/`max_price`, `min_year`/`max_year`,\n`body_type`, `fuel_type`, `transmission`, `drive_type`, `country`,\n`color`, `near`+`radius_km`, `modification_id`, `is_new`, `company_id`,\n\u0441\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0439 `search`), \u043f\u043b\u044e\u0441 `limit`/`offset` **\u043f\u043e \u0433\u0440\u0443\u043f\u043f\u0430\u043c** \u0438 `sort`.\n\n\u0412\u0441\u0435 \u0430\u0433\u0440\u0435\u0433\u0430\u0442\u044b (`total_count`, `min_total_price_rub`, `variants[].count`)\n\u0441\u0447\u0438\u0442\u0430\u044e\u0442\u0441\u044f **\u043f\u043e \u0432\u0441\u0435\u0439 \u0433\u0440\u0443\u043f\u043f\u0435 \u043d\u0430 \u0441\u0435\u0440\u0432\u0435\u0440\u0435** \u2014 \u0447\u0435\u0441\u0442\u043d\u044b\u0435 \u0447\u0438\u0441\u043b\u0430 \u0431\u0435\u0437 \u0441\u044d\u043c\u043f\u043b\u0430.\n`variants[].representative` \u2014 \u043f\u043e\u043b\u043d\u044b\u0439 \u043e\u0431\u044a\u0435\u043a\u0442 `Car` \u0441\u0430\u043c\u043e\u0433\u043e \u0434\u0435\u0448\u0451\u0432\u043e\u0433\u043e\n\u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0430 \u0446\u0432\u0435\u0442\u0430. `variants[].color` \u2014 \u043d\u043e\u0440\u043c\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u0446\u0432\u0435\u0442\n(`white`/`black`/\u2026) \u0438\u043b\u0438 `null`.\n","parameters":[{"description":"\u0421\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0439 \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 (\u043a\u0430\u043a \u0432 /v1/cars)","in":"query","name":"search","type":"string"},{"in":"query","name":"brand","type":"string"},{"in":"query","name":"model","type":"string"},{"default":"car","in":"query","name":"vehicle_type","type":"string"},{"in":"query","name":"body_type","type":"string"},{"in":"query","name":"fuel_type","type":"string"},{"in":"query","name":"transmission","type":"string"},{"in":"query","name":"drive_type","type":"string"},{"in":"query","name":"country","type":"string"},{"in":"query","name":"color","type":"string"},{"in":"query","name":"min_price","type":"integer"},{"in":"query","name":"max_price","type":"integer"},{"in":"query","name":"min_year","type":"integer"},{"in":"query","name":"max_year","type":"integer"},{"in":"query","name":"min_mileage","type":"integer"},{"in":"query","name":"max_mileage","type":"integer"},{"in":"query","name":"min_power","type":"integer"},{"in":"query","name":"max_power","type":"integer"},{"in":"query","name":"min_engine","type":"number"},{"in":"query","name":"max_engine","type":"number"},{"enum":[0,1],"in":"query","name":"is_new","type":"integer"},{"in":"query","name":"modification_id","type":"integer"},{"example":"79221,67234","in":"query","name":"modification_ids","type":"string"},{"example":"55.755864,37.617698","in":"query","name":"near","type":"string"},{"example":50,"in":"query","name":"radius_km","type":"number"},{"description":"UUID \u0434\u0438\u043b\u0435\u0440\u0430 (\u043a\u0430\u043a \u0432 /v1/cars)","in":"query","name":"company_id","type":"string"},{"default":"appeal_score","description":"\u0421\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043a\u0430 \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u041d\u0410 \u0423\u0420\u041e\u0412\u041d\u0415 \u0413\u0420\u0423\u041f\u041f\u042b. `total_price_rub` (`order=ASC|DESC`) \u2192 \u043f\u043e `min_total_price_rub` \u0433\u0440\u0443\u043f\u043f\u044b; `year` (`order=DESC`) \u2192 \u043f\u043e \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u043e\u043c\u0443 \u0433\u043e\u0434\u0443; `appeal_score` (\u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e) \u2192 \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u043f\u043e\u0440\u044f\u0434\u043e\u043a (\u043b\u0443\u0447\u0448\u0438\u0439 `total_score` \u0432 \u0433\u0440\u0443\u043f\u043f\u0435). \u0410\u043b\u0438\u0430\u0441\u044b `price_asc`/`price_desc`/`year_desc` \u0442\u043e\u0436\u0435 \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u044e\u0442\u0441\u044f.\n","enum":["appeal_score","total_price_rub","year","price_asc","price_desc","year_desc"],"in":"query","name":"sort","type":"string"},{"default":"DESC","enum":["ASC","DESC"],"in":"query","name":"order","type":"string"},{"default":20,"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u0413\u0420\u0423\u041f\u041f \u0432\u0435\u0440\u043d\u0443\u0442\u044c","in":"query","maximum":100,"name":"limit","type":"integer"},{"default":0,"description":"\u0421\u043c\u0435\u0449\u0435\u043d\u0438\u0435 \u043f\u043e \u0413\u0420\u0423\u041f\u041f\u0410\u041c","in":"query","name":"offset","type":"integer"},{"default":"ru","description":"\u042f\u0437\u044b\u043a \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u043c\u044b\u0445 \u043f\u043e\u043b\u0435\u0439 \u0432 `variants[].representative` \u0438 \u043c\u0435\u0442\u043a\u0435 `variants[].color` (\u043a\u0430\u043a \u0432 /v1/cars).","example":"en","in":"query","name":"lang","type":"string"},{"default":"RUB","description":"\u0412\u0430\u043b\u044e\u0442\u0430 \u0446\u0435\u043d `variants[].representative` (\u0430\u0434\u0434\u0438\u0442\u0438\u0432\u043d\u044b\u0439 \u0431\u043b\u043e\u043a `price_converted`, \u043a\u0430\u043a \u0432 /v1/cars). \u0413\u0440\u0443\u043f\u043f\u043e\u0432\u043e\u0439 \u0430\u0433\u0440\u0435\u0433\u0430\u0442 `min_total_price_rub` \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0432 \u0440\u0443\u0431\u043b\u044f\u0445. `RUB` / \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u2192 \u0431\u0435\u0437 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0430\u0446\u0438\u0438.","example":"USD","in":"query","name":"currency","type":"string"}],"responses":{"200":{"description":"\u0413\u0440\u0443\u043f\u043f\u044b \u043c\u043e\u0434\u0435\u043b\u0435\u0439","schema":{"properties":{"groups":{"items":{"properties":{"brand":{"type":"string"},"min_total_price_rub":{"description":"\u0427\u0435\u0441\u0442\u043d\u0430\u044f \u00ab\u043e\u0442\u00bb \u043f\u043e \u0432\u0441\u0435\u0439 \u0433\u0440\u0443\u043f\u043f\u0435","type":"integer","x-nullable":true},"model":{"type":"string"},"title":{"example":"BMW X5","type":"string"},"total_count":{"description":"\u041b\u0438\u0441\u0442\u0438\u043d\u0433\u043e\u0432 \u0432 \u0433\u0440\u0443\u043f\u043f\u0435 \u0446\u0435\u043b\u0438\u043a\u043e\u043c","type":"integer"},"variants":{"description":"\u0426\u0432\u0435\u0442\u043e\u0432\u044b\u0435 \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u044b, \u043f\u043e \u0443\u0431\u044b\u0432\u0430\u043d\u0438\u044e count","items":{"properties":{"color":{"example":"white","type":"string","x-nullable":true},"count":{"type":"integer"},"representative":{"$ref":"#/definitions/Car"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"has_more":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total_groups":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u0432\u0441\u0435\u0433\u043e \u043c\u043e\u0434\u0435\u043b\u0435\u0439 \u043f\u043e\u0434 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u043c","type":"integer"}},"type":"object"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"502":{"description":"Upstream MCP \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041a\u0430\u0442\u0430\u043b\u043e\u0433, \u0441\u0433\u0440\u0443\u043f\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043f\u043e \u043c\u043e\u0434\u0435\u043b\u0438 (\u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 = brand+model)","tags":["catalog"]}},"/v1/cars/stats":{"post":{"consumes":["application/json"],"description":"\u041e\u0434\u043d\u0430 \u0443\u043d\u0438\u0432\u0435\u0440\u0441\u0430\u043b\u044c\u043d\u0430\u044f \u0440\u0443\u0447\u043a\u0430 \u0434\u043b\u044f \u0432\u0441\u0435\u0439 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0438 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430. \u041d\u0430 \u0432\u0445\u043e\u0434 \u2014 \u0442\u0435 \u0436\u0435\n\u0444\u0438\u043b\u044c\u0442\u0440\u044b, \u0447\u0442\u043e \u0443 `GET /v1/cars` (\u0432 \u043e\u0431\u044a\u0435\u043a\u0442\u0435 `filters`), \u043f\u043b\u044e\u0441 \u0434\u0435\u043a\u043b\u0430\u0440\u0430\u0446\u0438\u044f\n**\u0447\u0442\u043e** \u0430\u0433\u0440\u0435\u0433\u0438\u0440\u043e\u0432\u0430\u0442\u044c. \u041d\u0430 \u0432\u044b\u0445\u043e\u0434 \u2014 \u0442\u043e\u0447\u043d\u044b\u0435 \u0447\u0438\u0441\u043b\u0430 \u0431\u0435\u0437 \u0441\u044d\u043c\u043f\u043b\u0438\u043d\u0433\u0430: `total`\n\u0437\u0434\u0435\u0441\u044c \u0432\u0441\u0435\u0433\u0434\u0430 \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0435\u0442 \u0441 `total` \u0438\u0437 `/v1/cars` \u043f\u0440\u0438 \u0442\u0435\u0445 \u0436\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u0445.\n\n**\u041d\u043e\u0432\u044b\u0439 \u0433\u0440\u0430\u0444\u0438\u043a = \u043d\u043e\u0432\u043e\u0435 \u0438\u043c\u044f \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435, \u043d\u0438\u043a\u043e\u0433\u0434\u0430 \u043d\u0435 \u043d\u043e\u0432\u044b\u0439 \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442.**\n\n\u0427\u0435\u0442\u044b\u0440\u0435 \u043d\u0435\u0437\u0430\u0432\u0438\u0441\u0438\u043c\u044b\u0445 \u0431\u043b\u043e\u043a\u0430 (\u0432\u0441\u0435 \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b):\n\n- **`facets`** \u2014 \u043a\u0430\u0442\u0435\u0433\u043e\u0440\u0438\u0430\u043b\u044c\u043d\u044b\u0435 \u0441\u0447\u0451\u0442\u0447\u0438\u043a\u0438 (`brand`, `fuel_type`,\n  `color`, \u2026) \u2192 \u043c\u0430\u0441\u0441\u0438\u0432 `{value, count}` (\u0434\u043b\u044f `brand` \u0435\u0449\u0451 `label`).\n  \u042d\u043b\u0435\u043c\u0435\u043d\u0442 \u2014 \u0441\u0442\u0440\u043e\u043a\u0430-\u043f\u043e\u043b\u0435 \u0438\u043b\u0438 \u043e\u0431\u044a\u0435\u043a\u0442 `{field, limit, min_count}`.\n- **`histograms`** \u2014 \u0447\u0438\u0441\u043b\u043e\u0432\u044b\u0435 \u0440\u0430\u0441\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f (`price_rub`, `power_hp`,\n  `mileage`, \u2026). \u041e\u0431\u044a\u0435\u043a\u0442 `\u043f\u043e\u043b\u0435 \u2192 {bins | step, min?, max?}`\n  (\u0440\u043e\u0432\u043d\u043e \u043e\u0434\u043d\u043e \u0438\u0437 `bins`/`step`). \u041e\u0442\u0432\u0435\u0442: `{min, max, step?, bins:[{lo,hi,count}]}`.\n- **`stats`** \u2014 \u0441\u0432\u043e\u0434\u043a\u0430 \u043f\u043e \u0447\u0438\u0441\u043b\u043e\u0432\u044b\u043c \u043f\u043e\u043b\u044f\u043c: \u043c\u0430\u0441\u0441\u0438\u0432 \u0438\u043c\u0451\u043d \u043f\u043e\u043b\u0435\u0439 \u2192\n  `{count, min, max, mean, median, p25, p75, sum}`.\n- **`breakdowns`** \u2014 \u0433\u0440\u0443\u043f\u043f\u0438\u0440\u043e\u0432\u043a\u0430 \u0441 \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u043e\u0441\u0442\u044c\u044e. `by` \u2014 \u043a\u0430\u0442\u0435\u0433\u043e\u0440\u0438\u0430\u043b\u044c\u043d\u043e\u0435\n  \u043f\u043e\u043b\u0435 (\u0441\u0442\u0440\u043e\u043a\u0430) **\u0438\u043b\u0438** \u0447\u0438\u0441\u043b\u043e\u0432\u044b\u0435 \u043a\u043e\u0440\u0437\u0438\u043d\u044b `{field, buckets:[...] | bins | step}`.\n  \u0412\u043d\u0443\u0442\u0440\u0438 \u0433\u0440\u0443\u043f\u043f\u044b \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e `stats`, `histogram`, `facets`.\n  \u041f\u043e\u043a\u0440\u044b\u0432\u0430\u0435\u0442 ridgeline (origin \u2192 \u0433\u0438\u0441\u0442\u043e\u0433\u0440\u0430\u043c\u043c\u0430 \u043c\u043e\u0449\u043d\u043e\u0441\u0442\u0438), cost waterfall\n  (\u0446\u0435\u043d\u043e\u0432\u044b\u0435 \u043a\u043e\u0440\u0437\u0438\u043d\u044b \u2192 \u0441\u0440\u0435\u0434\u043d\u0438\u0435 \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u044b), \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u044e (brand \u2192 model).\n\n**\u0412\u0438\u0440\u0442\u0443\u0430\u043b\u044c\u043d\u043e\u0435 \u0438\u0437\u043c\u0435\u0440\u0435\u043d\u0438\u0435 `origin`** (\u0441\u0442\u0440\u0430\u043d\u0430 \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u044f \u0431\u0440\u0435\u043d\u0434\u0430:\n\u0413\u0435\u0440\u043c\u0430\u043d\u0438\u044f / \u041a\u043e\u0440\u0435\u044f / \u041a\u0438\u0442\u0430\u0439 / \u042f\u043f\u043e\u043d\u0438\u044f / \u0414\u0440\u0443\u0433\u0438\u0435) \u0441\u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u0431\u044d\u043a\u0435\u043d\u0434\u0435 \u2014\n\u0434\u043e\u0441\u0442\u0443\u043f\u043d\u043e \u043a\u0430\u043a \u043f\u043e\u043b\u0435 \u0432 `facets` \u0438 `breakdowns.by`.\n\n\u041b\u0438\u043c\u0438\u0442\u044b: \u226412 \u0444\u0430\u0441\u0435\u0442\u043e\u0432, \u22648 \u0433\u0438\u0441\u0442\u043e\u0433\u0440\u0430\u043c\u043c, \u226416 stats-\u043f\u043e\u043b\u0435\u0439, \u22646 breakdowns,\n\u2264100 bins. \u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u043e\u0435 \u0438\u043c\u044f \u043f\u043e\u043b\u044f / \u043f\u0440\u0435\u0432\u044b\u0448\u0435\u043d\u0438\u0435 \u043b\u0438\u043c\u0438\u0442\u0430 / \u043a\u0440\u0438\u0432\u043e\u0439 \u0431\u043b\u043e\u043a \u2192 `400`.\n\n\u0413\u0440\u0430\u043d\u0438\u0446\u0430: \u043a\u0430\u0440\u0442\u0438\u043d\u043a\u0438 \u0438 \u043f\u0440\u0438\u043c\u0435\u0440\u044b \u043a\u0430\u0440\u0442\u043e\u0447\u0435\u043a \u044d\u0442\u0430 \u0440\u0443\u0447\u043a\u0430 \u041d\u0415 \u043e\u0442\u0434\u0430\u0451\u0442 \u2014 \u0434\u043b\u044f\n\u0441\u044d\u043c\u043f\u043b\u0430 \u043c\u0430\u0448\u0438\u043d \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 `GET /v1/cars?limit=200`.\n","parameters":[{"in":"body","name":"body","required":false,"schema":{"properties":{"breakdowns":{"example":[{"by":"origin","histogram":{"bins":20,"field":"power_hp"}},{"by":{"buckets":[0,2000000,5000000,null],"field":"total_price_rub"},"stats":["duty_rub","delivery_rub"]}],"items":{"type":"object"},"type":"array"},"facets":{"example":["brand","fuel_type",{"field":"color","limit":8,"min_count":2}],"items":{"type":"object"},"type":"array"},"filters":{"description":"\u0422\u0435 \u0436\u0435 \u043f\u043e\u043b\u044f, \u0447\u0442\u043e query-\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b `/v1/cars`\n(`brand`, `model`, `min_price`, `max_price`, `min_year`,\n`near`+`radius_km`, `company_id`, `search`, \u2026). \u041c\u0430\u0441\u0441\u0438\u0432\u044b\n\u0437\u0430\u0434\u0430\u044e\u0442\u0441\u044f JSON-\u043c\u0430\u0441\u0441\u0438\u0432\u043e\u043c. \u041f\u0443\u0441\u0442\u043e\u0439 \u043e\u0431\u044a\u0435\u043a\u0442 \u2192 \u0432\u0435\u0441\u044c \u043a\u0430\u0442\u0430\u043b\u043e\u0433.\n","example":{"brand":"BMW","max_price":8000000,"min_price":1000000},"type":"object"},"histograms":{"example":{"power_hp":{"min":0,"step":50},"price_rub":{"bins":20}},"type":"object"},"stats":{"example":["total_price_rub","power_hp"],"items":{"type":"string"},"type":"array"}},"type":"object"}}],"responses":{"200":{"description":"`{total, filters_echo, facets?, histograms?, stats?, breakdowns?}` \u2014\n\u043f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0437\u0430\u043f\u0440\u043e\u0448\u0435\u043d\u043d\u044b\u0435 \u0431\u043b\u043e\u043a\u0438.\n"},"400":{"description":"\u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u043e\u0435 \u043f\u043e\u043b\u0435 / \u043a\u0440\u0438\u0432\u043e\u0439 \u0431\u043b\u043e\u043a / \u043f\u0440\u0435\u0432\u044b\u0448\u0435\u043d\u0438\u0435 \u043b\u0438\u043c\u0438\u0442\u0430","schema":{"$ref":"#/definitions/Error"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"502":{"description":"Upstream MCP \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u0410\u0433\u0440\u0435\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u0430\u044f \u0441\u0442\u0430\u0442\u0438\u0441\u0442\u0438\u043a\u0430 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430 (\u0442\u043e\u0447\u043d\u044b\u0435 \u0447\u0438\u0441\u043b\u0430)","tags":["catalog"]}},"/v1/cars/suggest":{"post":{"consumes":["application/json"],"description":"\u041a\u0430\u043d\u0430\u043b-\u0432\u0438\u0442\u0440\u0438\u043d\u0430 \u0440\u0438\u0441\u0443\u0435\u0442 \u0447\u0438\u043f\u044b-\u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0438 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0435\u0433\u043e \u0448\u0430\u0433\u0430 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u0446\u0438\u0438, \u043d\u0435 \u0437\u043d\u0430\u044f\n\u043d\u0438\u0447\u0435\u0433\u043e \u043f\u0440\u043e \u0441\u043a\u043b\u0430\u0434. \u041b\u043e\u0433\u0438\u043a\u0430 \u00ab\u0447\u0442\u043e \u043f\u0440\u0435\u0434\u043b\u043e\u0436\u0438\u0442\u044c \u0434\u0430\u043b\u044c\u0448\u0435\u00bb \u0436\u0438\u0432\u0451\u0442 \u0432 \u0444\u0430\u0441\u0430\u0434\u0435: \u044d\u0442\u0430 \u0440\u0443\u0447\u043a\u0430\n\u043e\u0431\u043e\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442 \u0430\u0433\u0440\u0435\u0433\u0430\u0442\u043e\u0440 `POST /v1/cars/stats` \u0432 \u0433\u043e\u0442\u043e\u0432\u044b\u0435 \u0433\u0440\u0443\u043f\u043f\u044b \u0447\u0438\u043f\u043e\u0432.\n\n\u0414\u0432\u0430 \u0442\u0438\u043f\u0430 \u0433\u0440\u0443\u043f\u043f:\n\n- **`narrow`** (drill-down) \u2014 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 **\u0441\u0443\u0436\u0430\u044e\u0442** \u0442\u0435\u043a\u0443\u0449\u0443\u044e \u0432\u044b\u0431\u043e\u0440\u043a\u0443\n  (`count < total`). \u0418\u0434\u0443\u0442 \u043f\u043e \u0432\u043e\u0440\u043e\u043d\u043a\u0435 `vehicle_type \u2192 brand \u2192 model \u2192\n  body_type \u2192 price \u2192 power \u2192 year \u2192 fuel/\u043f\u0440\u0438\u0432\u043e\u0434/\u043a\u043e\u0440\u043e\u0431\u043a\u0430/\u0446\u0432\u0435\u0442`.\n- **`pivot`** (\u0441\u043e\u0441\u0435\u0434\u0438) \u2014 \u0434\u0440\u0443\u0433\u0438\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u0441\u0430\u043c\u043e\u0433\u043e \u0433\u043b\u0443\u0431\u043e\u043a\u043e \u0437\u0430\u043f\u0438\u043d\u0435\u043d\u043d\u043e\u0433\u043e\n  \u0438\u0437\u043c\u0435\u0440\u0435\u043d\u0438\u044f (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043f\u0440\u0438 `brand=BMW` \u2014 \u00ab\u043f\u043e\u0445\u043e\u0436\u0438\u0435 \u043c\u0430\u0440\u043a\u0438\u00bb), \u043f\u043e\u0441\u0447\u0438\u0442\u0430\u043d\u043d\u044b\u0435 \u0432\n  \u043f\u0440\u0435\u0434\u0435\u043b\u0430\u0445 \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u044b\u0445 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432. \u041e\u0442\u0434\u0430\u044e\u0442\u0441\u044f \u0441\u0434\u0435\u0440\u0436\u0430\u043d\u043d\u043e \u0438 \u0432\u0441\u0435\u0433\u0434\u0430 \u041f\u041e\u0421\u041b\u0415 narrow.\n\n\u041f\u0440\u0430\u0432\u0438\u043b\u0430 \u0444\u0430\u0441\u0430\u0434\u0430: \u043a\u0430\u0436\u0434\u0430\u044f \u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0430 \u0438\u043c\u0435\u0435\u0442 `count > 0`; `narrow` \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e\n`count < total`; \u0443\u0436\u0435 \u0437\u0430\u043f\u0438\u043d\u0435\u043d\u043d\u043e\u0435 \u0438\u0437\u043c\u0435\u0440\u0435\u043d\u0438\u0435 \u043d\u0435 \u043f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u0435\u0442\u0441\u044f \u043a\u0430\u043a `narrow`;\n\u0447\u0438\u0441\u043b\u043e\u0432\u043e\u0435 \u0438\u0437\u043c\u0435\u0440\u0435\u043d\u0438\u0435 \u043d\u0435 \u043e\u0442\u0434\u0430\u0451\u0442\u0441\u044f, \u0435\u0441\u043b\u0438 \u0432 \u0432\u044b\u0431\u043e\u0440\u043a\u0435 \u043d\u0435\u0442 \u0434\u0430\u043d\u043d\u044b\u0445 (inventory-aware\n\u2014 \u043a\u0430\u043d\u0430\u043b \u043d\u0435 \u0432\u0438\u0434\u0438\u0442 \u0434\u044b\u0440 \u0441\u043a\u043b\u0430\u0434\u0430); `value` \u2014 \u043a\u0430\u043d\u043e\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u043a\u043b\u044e\u0447 (`jet_ski` \u0441\n\u043f\u043e\u0434\u0447\u0451\u0440\u043a\u0438\u0432\u0430\u043d\u0438\u0435\u043c, `body_type` \u0441\u043b\u0430\u0433\u043e\u043c `\u0412\u043d\u0435\u0434\u043e\u0440\u043e\u0436\u043d\u0438\u043a\u2192suv`), `label` \u2014\n\u0447\u0435\u043b\u043e\u0432\u0435\u043a\u043e\u0447\u0438\u0442\u0430\u0435\u043c\u044b\u0439 \u043b\u043e\u043a\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u0442\u0435\u043a\u0441\u0442; `patch` \u043c\u0451\u0440\u0436\u0438\u0442\u0441\u044f \u0432 \u0442\u0435\u043a\u0443\u0449\u0438\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b\n(`pivot` \u2014 \u0437\u0430\u043c\u0435\u0449\u0430\u0435\u0442 \u0437\u0430\u043f\u0438\u043d\u0435\u043d\u043d\u043e\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435) \u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u043e \u043f\u0440\u0438\u043c\u0435\u043d\u0438\u043c \u043a `/v1/cars`.\n\n`total` \u0432\u0441\u0435\u0433\u0434\u0430 \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0435\u0442 \u0441 `total` \u0438\u0437 `/v1/cars` \u043f\u0440\u0438 \u0442\u0435\u0445 \u0436\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u0445. \u041d\u0435\u0442\n\u043e\u0441\u043c\u044b\u0441\u043b\u0435\u043d\u043d\u044b\u0445 \u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043e\u043a \u2192 `200` \u0441 `groups: []` (\u043d\u0435 \u043e\u0448\u0438\u0431\u043a\u0430).\n\n`vehicle_type` \u0437\u0434\u0435\u0441\u044c \u2014 \u043f\u043e\u043b\u0435 \u0432\u0435\u0440\u0445\u043d\u0435\u0433\u043e \u0443\u0440\u043e\u0432\u043d\u044f (\u043d\u0435 \u0432\u043d\u0443\u0442\u0440\u0438 `filters`): \u0435\u0441\u043b\u0438\n\u0437\u0430\u0434\u0430\u043d\u043e \u2014 \u0442\u0438\u043f \u0437\u0430\u043f\u0438\u043d\u0435\u043d \u0438 \u043d\u0435 \u043f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u0435\u0442\u0441\u044f; \u0435\u0441\u043b\u0438 \u043e\u043f\u0443\u0449\u0435\u043d\u043e \u2014 \u0432\u044b\u0431\u043e\u0440\u043a\u0430 \u043e\u0445\u0432\u0430\u0442\u044b\u0432\u0430\u0435\u0442\n\u0432\u0441\u0435 \u0442\u0438\u043f\u044b \u0438 `vehicle_type` \u0441\u0430\u043c \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0441\u044f \u043f\u0435\u0440\u0432\u043e\u0439 \u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u043e\u0439.\n","parameters":[{"in":"body","name":"body","required":false,"schema":{"properties":{"currency":{"example":"RUB","type":"string"},"filters":{"description":"\u0422\u0435 \u0436\u0435 \u043f\u043e\u043b\u044f, \u0447\u0442\u043e query-\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b `/v1/cars`\n(`brand`, `model`, `body_type`, `min_price`/`max_price`,\n`min_year`/`max_year`, `company_id`, `search`, \u2026). \u0422\u043e\u0442 \u0436\u0435 shape,\n\u0447\u0442\u043e `filters_applied` \u0438\u0437 `/v1/chat`. \u041f\u0443\u0441\u0442\u043e\u0439 \u043e\u0431\u044a\u0435\u043a\u0442 \u2192 \u0432\u0435\u0441\u044c \u043a\u0430\u0442\u0430\u043b\u043e\u0433.\n","example":{"brand":"BMW"},"type":"object"},"locale":{"example":"ru","type":"string"},"max_groups":{"description":"\u041a\u0430\u043f \u0447\u0438\u0441\u043b\u0430 \u0433\u0440\u0443\u043f\u043f (1..8)","example":4,"type":"integer"},"per_group":{"description":"\u041a\u0430\u043f \u0447\u0438\u0441\u043b\u0430 \u0447\u0438\u043f\u043e\u0432 \u0432 \u0433\u0440\u0443\u043f\u043f\u0435 (1..12)","example":6,"type":"integer"},"vehicle_type":{"description":"\u041e\u043f\u0446.: car|motorcycle|truck|atv|snowmobile|construction|jet_ski. \u041e\u043f\u0443\u0449\u0435\u043d\u043e \u2192 \u043f\u043e\u0434\u0441\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f.","example":"car","type":"string"}},"type":"object"}}],"responses":{"200":{"description":"`{total, groups:[{dimension, kind, title, suggestions:[{value, label,\ncount, kind, patch}]}]}`. `groups` \u043f\u0443\u0441\u0442, \u0435\u0441\u043b\u0438 \u043e\u0441\u043c\u044b\u0441\u043b\u0435\u043d\u043d\u044b\u0445 \u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043e\u043a \u043d\u0435\u0442.\n","examples":{"application/json":{"groups":[{"dimension":"model","kind":"narrow","suggestions":[{"count":308,"kind":"narrow","label":"X5","patch":{"model":"X5"},"value":"X5"},{"count":272,"kind":"narrow","label":"X1","patch":{"model":"X1"},"value":"X1"}],"title":"\u041c\u043e\u0434\u0435\u043b\u044c"},{"dimension":"body_type","kind":"narrow","suggestions":[{"count":1303,"kind":"narrow","label":"\u0412\u043d\u0435\u0434\u043e\u0440\u043e\u0436\u043d\u0438\u043a","patch":{"body_type":"\u0412\u043d\u0435\u0434\u043e\u0440\u043e\u0436\u043d\u0438\u043a"},"value":"suv"}],"title":"\u041a\u0443\u0437\u043e\u0432"},{"dimension":"price","kind":"narrow","suggestions":[{"count":320,"kind":"narrow","label":"\u0434\u043e 3 \u043c\u043b\u043d \u20bd","patch":{"max_price":3000000},"value":"to_3m"}],"title":"\u0426\u0435\u043d\u0430"}],"total":2744}}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"502":{"description":"Upstream MCP \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u0427\u0438\u043f\u044b-\u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0438 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0435\u0433\u043e \u0444\u0438\u043b\u044c\u0442\u0440\u0430 (drill-down + \u0441\u043e\u0441\u0435\u0434\u0438)","tags":["catalog"]}},"/v1/cars/{car_id}":{"get":{"parameters":[{"in":"path","name":"car_id","required":true,"type":"integer"},{"description":"`embed=modification` \u2014 \u0432\u0435\u0440\u043d\u0443\u0442\u044c \u043c\u0430\u0448\u0438\u043d\u0443 **\u0432\u043c\u0435\u0441\u0442\u0435** \u0441 \u043f\u043e\u043b\u043d\u043e\u0439 \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u043e\u0439 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u043e\u0439 \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043e\u0434\u043d\u0438\u043c \u043e\u0442\u0432\u0435\u0442\u043e\u043c: \u0444\u0430\u0441\u0430\u0434 \u0441\u0430\u043c \u0440\u0435\u0437\u043e\u043b\u0432\u0438\u0442 `platform-modification` (`modification.gumy.space`) \u043f\u043e `modification_id` \u043c\u0430\u0448\u0438\u043d\u044b \u0438 \u043a\u043b\u0430\u0434\u0451\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432 \u043e\u0431\u044a\u0435\u043a\u0442 `modification`. \u041a\u0430\u043d\u0430\u043b \u043d\u0435 \u0445\u043e\u0434\u0438\u0442 \u043d\u0430 \u0441\u0430\u0431\u0434\u043e\u043c\u0435\u043d \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0441\u0430\u043c. \u0411\u0435\u0437 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 \u043e\u0431\u044a\u0435\u043a\u0442\u0430 `modification` \u0432 \u043e\u0442\u0432\u0435\u0442\u0435 \u043d\u0435\u0442 (\u043e\u0431\u0440\u0430\u0442\u043d\u0430\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c). \u0415\u0441\u043b\u0438 \u0443 \u043c\u0430\u0448\u0438\u043d\u044b \u043d\u0435\u0442 `modification_id` \u0438\u043b\u0438 \u0441\u0435\u0440\u0432\u0438\u0441 \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d \u2014 `modification` \u0431\u0443\u0434\u0435\u0442 `null`, \u043e\u0442\u0432\u0435\u0442 \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e `200`.\n","enum":["modification"],"in":"query","name":"embed","type":"string"},{"description":"UUID \u0434\u0438\u043b\u0435\u0440\u0430. \u0415\u0441\u043b\u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u043d, \u0434\u0435\u0442\u0430\u043b\u044c \u0438\u0449\u0435\u0442\u0441\u044f \u0432 \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u0435 \u0434\u0438\u043b\u0435\u0440\u0430 (`frontend.cars_for_company`) \u0438 \u043e\u0431\u043e\u0433\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0435\u0433\u043e \u043d\u0430\u0446\u0435\u043d\u043a\u043e\u0439/\u043a\u043e\u043d\u0442\u0430\u043a\u0442\u0430\u043c\u0438; \u043c\u0430\u0448\u0438\u043d\u0430 \u0432\u043d\u0435 \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u044f \u0434\u0438\u043b\u0435\u0440\u0430 \u2192 `404`. \u0411\u0435\u0437 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 \u2014 \u0432\u0438\u0442\u0440\u0438\u043d\u043d\u044b\u0439 \u0440\u0435\u0436\u0438\u043c.\n","format":"uuid","in":"query","name":"company_id","type":"string"},{"default":"ru","description":"\u042f\u0437\u044b\u043a \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u043c\u044b\u0445 \u043f\u043e\u043b\u0435\u0439 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 (\u043a\u0430\u043a \u0432 /v1/cars).","example":"en","in":"query","name":"lang","type":"string"},{"default":"RUB","description":"\u0412\u0430\u043b\u044e\u0442\u0430 \u0446\u0435\u043d \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u2014 \u0430\u0434\u0434\u0438\u0442\u0438\u0432\u043d\u044b\u0439 \u0431\u043b\u043e\u043a `price_converted` (\u043a\u0430\u043a \u0432 /v1/cars). `RUB` / \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u2192 \u0431\u0435\u0437 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0430\u0446\u0438\u0438.","example":"USD","in":"query","name":"currency","type":"string"}],"responses":{"200":{"description":"\u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u0430\u0432\u0442\u043e\u043c\u043e\u0431\u0438\u043b\u044f (\u0441 `modification`, \u0435\u0441\u043b\u0438 \u0437\u0430\u043f\u0440\u043e\u0448\u0435\u043d `embed`)","schema":{"allOf":[{"$ref":"#/definitions/Car"},{"properties":{"modification":{"description":"\u041f\u043e\u043b\u043d\u0430\u044f \u0442\u0435\u0445\u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0438\u0437 `platform-modification` (\u043f\u043e\u043b\u0435 `id` \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0435\u0442 \u0441 `modification_id` \u043c\u0430\u0448\u0438\u043d\u044b; \u043d\u0430\u0431\u043e\u0440 \u043f\u043e\u043b\u0435\u0439 \u2014 \u0441\u043f\u0435\u043a\u0430 \u0434\u0432\u0438\u0433\u0430\u0442\u0435\u043b\u044f/\u0442\u0440\u0430\u043d\u0441\u043c\u0438\u0441\u0441\u0438\u0438/\u043a\u0443\u0437\u043e\u0432\u0430 \u0438 \u0442. \u0434.). \u041f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u0435\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u0438 `embed=modification`; `null`, \u0435\u0441\u043b\u0438 \u0443 \u043c\u0430\u0448\u0438\u043d\u044b \u043d\u0435\u0442 `modification_id` \u0438\u043b\u0438 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u043d\u0430.\n","nullable":true,"type":"object"}},"type":"object"}]}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"404":{"description":"\u041d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u043e","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u0414\u0435\u0442\u0430\u043b\u0438 \u0430\u0432\u0442\u043e\u043c\u043e\u0431\u0438\u043b\u044f","tags":["catalog"]}},"/v1/cars/{car_id}/similar":{"get":{"description":"\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0434\u043e `limit` \u043a\u0430\u0440\u0442\u043e\u0447\u0435\u043a \u0441\u043e \u0441\u0445\u043e\u0434\u043d\u044b\u043c \u0431\u0440\u0435\u043d\u0434\u043e\u043c / \u0442\u0438\u043f\u043e\u043c \u043a\u0443\u0437\u043e\u0432\u0430 \u0438\n\u0446\u0435\u043d\u043e\u0439 \u0432 \u043f\u0440\u0435\u0434\u0435\u043b\u0430\u0445 \u00b125 % \u043e\u0442 \u0438\u0441\u0445\u043e\u0434\u043d\u043e\u0433\u043e \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f. \u0420\u0430\u043d\u0436\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043f\u043e\n`total_score` DESC.\n\n\u0415\u0441\u043b\u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u043d `company_id`, \u0432 \u0432\u044b\u0431\u043e\u0440\u043a\u0443 \u0438\u0434\u0443\u0442 **\u0442\u043e\u043b\u044c\u043a\u043e** \u043c\u0430\u0448\u0438\u043d\u044b \u0438\u0437\n\u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u044f \u0434\u0438\u043b\u0435\u0440\u0430 (`frontend.cars_for_company`). \u0415\u0441\u043b\u0438 \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u0439\n`car_id` \u043d\u0435 \u0432\u0445\u043e\u0434\u0438\u0442 \u0432 \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u044c \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 \u2014 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u043f\u0443\u0441\u0442\u043e\u0439\n\u043c\u0430\u0441\u0441\u0438\u0432 `cars` (\u0430 \u043d\u0435 404), \u0447\u0442\u043e\u0431\u044b \u043a\u043b\u0438\u0435\u043d\u0442 \u043c\u043e\u0433 \u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u043e \u043e\u0442\u0440\u0438\u0441\u043e\u0432\u0430\u0442\u044c\n\u00ab\u043d\u0435\u0442 \u043f\u043e\u0445\u043e\u0436\u0438\u0445\u00bb.\n","parameters":[{"in":"path","name":"car_id","required":true,"type":"integer"},{"description":"UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438-\u0434\u0438\u043b\u0435\u0440\u0430","in":"query","name":"company_id","type":"string"},{"default":8,"in":"query","maximum":20,"minimum":1,"name":"limit","type":"integer"},{"default":"ru","description":"\u042f\u0437\u044b\u043a \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u043c\u044b\u0445 \u043f\u043e\u043b\u0435\u0439 \u043a\u0430\u0440\u0442\u043e\u0447\u0435\u043a (\u043a\u0430\u043a \u0432 /v1/cars).","example":"en","in":"query","name":"lang","type":"string"},{"default":"RUB","description":"\u0412\u0430\u043b\u044e\u0442\u0430 \u0446\u0435\u043d \u043a\u0430\u0440\u0442\u043e\u0447\u0435\u043a \u2014 \u0430\u0434\u0434\u0438\u0442\u0438\u0432\u043d\u044b\u0439 \u0431\u043b\u043e\u043a `price_converted` (\u043a\u0430\u043a \u0432 /v1/cars). `RUB` / \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u2192 \u0431\u0435\u0437 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0430\u0446\u0438\u0438.","example":"USD","in":"query","name":"currency","type":"string"}],"responses":{"200":{"description":"\u041f\u043e\u0445\u043e\u0436\u0438\u0435 \u0430\u0432\u0442\u043e","schema":{"properties":{"cars":{"items":{"$ref":"#/definitions/Car"},"type":"array"},"company_id":{"format":"uuid","type":"string"},"contacts":{"$ref":"#/definitions/Car/properties/contacts"},"lang":{"description":"\u042d\u0445\u043e \u044f\u0437\u044b\u043a\u0430 \u0432\u044b\u0434\u0430\u0447\u0438.","example":"en","type":"string"}},"type":"object"}},"400":{"description":"\u041d\u0435\u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u044b\u0439 `car_id`","schema":{"$ref":"#/definitions/Error"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041f\u043e\u0445\u043e\u0436\u0438\u0435 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u0434\u043b\u044f \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0438","tags":["catalog"]}},"/v1/chat":{"post":{"consumes":["application/json"],"description":"\u0422\u043e\u0442 \u0436\u0435 AI-\u0430\u0433\u0435\u043d\u0442, \u0447\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0432 \u0432\u0438\u0434\u0436\u0435\u0442\u0435 `widget.proride.io`.\n\n**\u041e\u0442\u0432\u0435\u0442 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442:**\n- `text` \u2014 \u0442\u0435\u043a\u0441\u0442 \u043e\u0442 \u0430\u0433\u0435\u043d\u0442\u0430 (\u043d\u0430 \u044f\u0437\u044b\u043a\u0435 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f);\n- `cars` \u2014 \u043c\u0430\u0441\u0441\u0438\u0432 \u043d\u0430\u0439\u0434\u0435\u043d\u043d\u044b\u0445 \u0430\u0432\u0442\u043e\u043c\u043e\u0431\u0438\u043b\u0435\u0439 \u0441 \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u044f\u043c\u0438 \u0438 \u0441\u0441\u044b\u043b\u043a\u0430\u043c\u0438 (\u043d\u0435 \u0431\u043e\u043b\u0435\u0435 `limit` \u0448\u0442\u0443\u043a).\n\n**\u0421\u0435\u0441\u0441\u0438\u044f:**\n\u041f\u043e\u043b\u0435 `user_id` \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u2014 \u043e\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a \u043a\u043b\u044e\u0447 \u0441\u0435\u0441\u0441\u0438\u0438. \u041f\u043e\u043a\u0430\n\u0432\u044b \u0448\u043b\u0451\u0442\u0435 \u043e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 `user_id`, \u0430\u0433\u0435\u043d\u0442 \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442 \u0434\u0438\u0430\u043b\u043e\u0433\u0430\n\u0438 \u043f\u0440\u0435\u0434\u043f\u043e\u0447\u0442\u0435\u043d\u0438\u044f \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u043c\u0435\u0436\u0434\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\u043c\u0438.\n\n**\u041a\u043e\u043d\u0442\u0440\u043e\u043b\u044c \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u0430 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432:**\n\u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 `limit` (1\u201320, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e 8) \u0440\u0435\u0436\u0435\u0442 \u043c\u0430\u0441\u0441\u0438\u0432 `cars`. \u0423\u0434\u043e\u0431\u043d\u043e \u0434\u043b\u044f \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0445 \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432 (4\u20136), \u043b\u0435\u043d\u0442 (10) \u0438\u043b\u0438 \u043a\u043e\u043c\u043f\u0430\u043a\u0442\u043d\u044b\u0445 \u0432\u0438\u0434\u0436\u0435\u0442\u043e\u0432 (3).\n","parameters":[{"in":"body","name":"body","required":true,"schema":{"properties":{"company_id":{"description":"UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438-\u0434\u0438\u043b\u0435\u0440\u0430. \u0415\u0441\u043b\u0438 \u043f\u0435\u0440\u0435\u0434\u0430\u043d \u2014 \u043f\u043e\u0438\u0441\u043a \u0438\u0434\u0451\u0442 **\u0442\u043e\u043b\u044c\u043a\u043e**\n\u043f\u043e \u043c\u0430\u0448\u0438\u043d\u0430\u043c, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u044e\u0442 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u043c \u044d\u0442\u043e\u0433\u043e \u0434\u0438\u043b\u0435\u0440\u0430\n(`frontend.cars_for_company(<company_id>)`). \u0411\u0435\u0437 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\n\u043f\u043e\u0438\u0441\u043a \u0432\u0435\u0434\u0451\u0442\u0441\u044f \u043f\u043e \u0432\u0441\u0435\u043c\u0443 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0443.\n\n\u041d\u0435\u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0439 `company_id` \u2192 0 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432 (\u043d\u0435 \u043e\u0448\u0438\u0431\u043a\u0430).\n\u041d\u0435\u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439 \u0444\u043e\u0440\u043c\u0430\u0442 UUID \u2192 `400 invalid company_id`.\n","example":"3269aded-e5bd-4b33-b288-50d0c33b8945","format":"uuid","type":"string"},"limit":{"default":8,"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u043a\u0430\u0440\u0442\u043e\u0447\u0435\u043a \u0430\u0432\u0442\u043e \u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0432\u0435\u0440\u043d\u0443\u0442\u044c \u0432 `cars[]`. \u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e 8, \u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c 20.\n\u0418\u0442\u043e\u0433\u043e\u0432\u044b\u0439 \u043c\u0430\u0441\u0441\u0438\u0432 `cars` \u0432\u0441\u0435\u0433\u0434\u0430 \u0443\u0441\u0435\u043a\u0430\u0435\u0442\u0441\u044f \u0434\u043e `limit`.\n","example":6,"maximum":20,"minimum":1,"type":"integer"},"message":{"description":"\u0421\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 \u043d\u0430 \u043b\u044e\u0431\u043e\u043c \u044f\u0437\u044b\u043a\u0435","example":"\u043f\u043e\u043a\u0430\u0436\u0438 \u0431\u0435\u043b\u0443\u044e Toyota Camry \u0434\u043e 3 \u043c\u043b\u043d","type":"string"},"near":{"description":"\u042f\u043a\u043e\u0440\u044c \u0433\u0435\u043e-\u0440\u0430\u0434\u0438\u0443\u0441\u0430: `\"<lat>,<lng>\"` (\u0434\u0435\u0441\u044f\u0442\u0438\u0447\u043d\u044b\u0435 \u0433\u0440\u0430\u0434\u0443\u0441\u044b\n\u0447\u0435\u0440\u0435\u0437 \u0437\u0430\u043f\u044f\u0442\u0443\u044e). \u041f\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0441\u044f **\u0432 \u043f\u0430\u0440\u0435** \u0441 `radius_km` \u2014\n\u0438\u043d\u0430\u0447\u0435 \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f.\n\n\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f, \u043a\u043e\u0433\u0434\u0430 \u043a\u043b\u0438\u0435\u043d\u0442 \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f\n(TG `location`, geolocation \u0438\u0437 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0430, \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0446\u0435\u043d\u0442\u0440\u0430\n\u043a\u0430\u0440\u0442\u044b). \u0421\u0435\u0440\u0432\u0435\u0440 \u043d\u0435 \u0440\u0430\u0437\u0440\u0435\u0448\u0430\u0435\u0442 `\"@me\"` \u2014 \u043a\u043b\u0438\u0435\u043d\u0442 \u0441\u0430\u043c\n\u043f\u043e\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u043f\u0435\u0440\u0435\u0434 \u0432\u044b\u0437\u043e\u0432\u043e\u043c.\n\n\u0415\u0441\u043b\u0438 \u0437\u0430\u043f\u0440\u043e\u0441 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u0444\u0440\u0430\u0437\u0443 \u00ab\u0440\u044f\u0434\u043e\u043c \u0441\u043e \u043c\u043d\u043e\u0439\u00bb / \u00abnear me\u00bb /\n\u00ab\u0432 \u0440\u0430\u0434\u0438\u0443\u0441\u0435 X \u043a\u043c \u043e\u0442 \u041c\u043e\u0441\u043a\u0432\u044b\u00bb, \u043f\u0430\u0440\u0441\u0435\u0440 \u0442\u043e\u0436\u0435 \u0438\u0437\u0432\u043b\u0435\u043a\u0430\u0435\u0442\n`near` + `radius_km`, \u043d\u043e \u0431\u0435\u0437 \u044f\u0432\u043d\u043e\u0433\u043e \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u043e\u0442 \u043a\u043b\u0438\u0435\u043d\u0442\u0430\n\u0441 `\"@me\"` \u0444\u0438\u043b\u044c\u0442\u0440 \u043f\u0440\u0438\u043c\u0435\u043d\u0451\u043d \u043d\u0435 \u0431\u0443\u0434\u0435\u0442 (\u0442\u0438\u0445\u043e \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f).\n\u0427\u0442\u043e\u0431\u044b \u0444\u0438\u043b\u044c\u0442\u0440 \u0441\u0440\u0430\u0431\u043e\u0442\u0430\u043b \u2014 \u043f\u0435\u0440\u0435\u0434\u0430\u0439\u0442\u0435 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u044f\u0432\u043d\u043e.\n","example":"55.755864,37.617698","type":"string"},"offset":{"default":0,"description":"\u0421\u043c\u0435\u0449\u0435\u043d\u0438\u0435 \u0432 \u043e\u0431\u0449\u0435\u043c \u043d\u0430\u0431\u043e\u0440\u0435 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432. \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0434\u043b\u044f \u043a\u043d\u043e\u043f\u043a\u0438 \u00ab\u0415\u0449\u0451\u00bb:\n\u043f\u0435\u0440\u0432\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 \u2014 `offset=0`, \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0430\u044f \u043f\u0430\u0447\u043a\u0430 \u2014 `offset=limit`, \u0437\u0430\u0442\u0435\u043c `2*limit` \u0438 \u0442. \u0434.\n\u0412 \u043e\u0442\u0432\u0435\u0442\u0435 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 `total` (\u0432\u0441\u0435\u0433\u043e \u043d\u0430\u0439\u0434\u0435\u043d\u043e) \u0438 `has_more` \u2014 \u0433\u0440\u0443\u0437\u0438\u0442\u0435 \u0435\u0449\u0451, \u043f\u043e\u043a\u0430 \u043e\u043d\u043e `true`.\n\n\u0414\u043b\u044f \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438 \u043f\u0440\u0438\u0441\u044b\u043b\u0430\u0439\u0442\u0435 \u0442\u043e\u0442 \u0436\u0435 `message`, \u0447\u0442\u043e \u0438 \u0432 \u043f\u0435\u0440\u0432\u043e\u043c \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u2014\n\u044d\u0442\u043e \u0433\u0430\u0440\u0430\u043d\u0442\u0438\u0440\u0443\u0435\u0442 \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432 \u043c\u0435\u0436\u0434\u0443 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430\u043c\u0438.\n","example":0,"minimum":0,"type":"integer"},"persona":{"description":"**\u041e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e.** \u00ab\u041b\u0438\u0447\u043d\u043e\u0441\u0442\u044c\u00bb (\u0433\u043e\u043b\u043e\u0441 \u043f\u0435\u0440\u0441\u043e\u043d\u0430\u0436\u0430 \u043a\u0430\u043d\u0430\u043b\u0430), \u0432 \u0441\u0442\u0438\u043b\u0435\n\u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u0430\u0433\u0435\u043d\u0442 \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442. \u0412\u043b\u0438\u044f\u0435\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430 \u0442\u043e\u043d \u0442\u0435\u043a\u0441\u0442\u0430 \u2014 \u043d\u0435 \u043e\u0442\u043c\u0435\u043d\u044f\u0435\u0442\n\u043e\u0441\u0442\u0430\u043b\u044c\u043d\u044b\u0435 \u043f\u0440\u0430\u0432\u0438\u043b\u0430 (\u0430\u0433\u0435\u043d\u0442 \u043d\u0435 \u0432\u044b\u0434\u0443\u043c\u044b\u0432\u0430\u0435\u0442 \u043c\u0430\u0448\u0438\u043d\u044b, \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u043d\u0430 \u044f\u0437\u044b\u043a\u0435\n\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f). \u041d\u0435\u0432\u0430\u043b\u0438\u0434\u043d\u0430\u044f/\u043e\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0449\u0430\u044f `persona` \u2192 \u043d\u0435\u0439\u0442\u0440\u0430\u043b\u044c\u043d\u044b\u0439\n\u0433\u043e\u043b\u043e\u0441. \u041d\u0435 \u043f\u0435\u0440\u0441\u0438\u0441\u0442\u0438\u0442\u0441\u044f.\n","properties":{"gender":{"description":"\u0413\u0440\u0430\u043c\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0440\u043e\u0434 \u0440\u0435\u0447\u0438 \u0430\u0433\u0435\u043d\u0442\u0430 \u043e \u0441\u0435\u0431\u0435.","enum":["male","female","neutral"],"example":"female","type":"string"},"name":{"description":"\u0418\u043c\u044f \u043f\u0435\u0440\u0441\u043e\u043d\u0430\u0436\u0430, \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u0430\u0433\u0435\u043d\u0442 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f.","example":"Cutie Madeline","type":"string"},"style":{"description":"\u041a\u0440\u0430\u0442\u043a\u043e\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0445\u0430\u0440\u0430\u043a\u0442\u0435\u0440\u0430/\u0442\u043e\u043d\u0430.","example":"\u0422\u0451\u043f\u043b\u0430\u044f, \u043b\u0430\u0441\u043a\u043e\u0432\u0430\u044f, \u0433\u043e\u0432\u043e\u0440\u0438\u0442 \u043c\u044f\u0433\u043a\u043e.","type":"string"}},"type":"object"},"platform":{"default":"api","description":"\u0418\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u043f\u043b\u043e\u0449\u0430\u0434\u043a\u0438 (web / telegram / ios / android / api / ...). \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0432\u043c\u0435\u0441\u0442\u0435 \u0441 `user_id` \u043a\u0430\u043a \u0441\u043e\u0441\u0442\u0430\u0432\u043d\u043e\u0439 \u043a\u043b\u044e\u0447 \u0438\u0441\u0442\u043e\u0440\u0438\u0438.","example":"api","type":"string"},"radius_km":{"description":"\u0420\u0430\u0434\u0438\u0443\u0441 \u0432 \u043a\u0438\u043b\u043e\u043c\u0435\u0442\u0440\u0430\u0445 (>0, \u226420015). \u041f\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0441\u044f **\u0432 \u043f\u0430\u0440\u0435**\n\u0441 `near`. \u041f\u043e\u0438\u0441\u043a \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u043c\u0430\u0448\u0438\u043d\u0430\u043c\u0438 \u0432 \u0433\u043e\u0440\u043e\u0434\u0430\u0445,\n\u0447\u0435\u0439 \u0446\u0435\u043d\u0442\u0440\u043e\u0438\u0434 (`ref_cities`) \u043f\u043e\u043f\u0430\u0434\u0430\u0435\u0442 \u0432 \u043a\u0440\u0443\u0433.\n","example":50,"maximum":20015,"minimum":0.1,"type":"number"},"user_id":{"description":"**\u041e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439** \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0432 \u0432\u0430\u0448\u0435\u0439 \u0441\u0438\u0441\u0442\u0435\u043c\u0435.\n\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a \u043a\u043b\u044e\u0447 \u0441\u0435\u0441\u0441\u0438\u0438: \u0430\u0433\u0435\u043d\u0442 \u043f\u043e\u043c\u043d\u0438\u0442 \u0438\u0441\u0442\u043e\u0440\u0438\u044e \u0434\u0438\u0430\u043b\u043e\u0433\u0430, \u043f\u0440\u0435\u0434\u044b\u0434\u0443\u0449\u0438\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b,\n\u0441\u043e\u0445\u0440\u0430\u043d\u0451\u043d\u043d\u044b\u0435 \u043f\u0440\u0435\u0434\u043f\u043e\u0447\u0442\u0435\u043d\u0438\u044f. \u041e\u0434\u0438\u043d\u0430\u043a\u043e\u0432\u044b\u0439 `user_id` \u2192 \u0442\u043e\u0442 \u0436\u0435 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442 \u043c\u0435\u0436\u0434\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\u043c\u0438.\n\u0424\u043e\u0440\u043c\u0430\u0442 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u043b\u044c\u043d\u044b\u0439 (UUID, \u0447\u0438\u0441\u043b\u043e\u0432\u043e\u0439 ID, email-hash \u0438 \u0442. \u0434.), \u043c\u0430\u043a\u0441. 128 \u0441\u0438\u043c\u0432\u043e\u043b\u043e\u0432.\n","example":"partner-42-u1337","type":"string"},"vehicle_type":{"default":"car","description":"\u0422\u0438\u043f \u0442\u0440\u0430\u043d\u0441\u043f\u043e\u0440\u0442\u0430 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e (\u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u043f\u0435\u0440\u0435\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0451\u043d \u0432 \u0442\u0435\u043a\u0441\u0442\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u0430)","enum":["car","motorcycle","jet_ski","atv","snowmobile","boat","yacht","aircraft","helicopter","rv","truck","construction"],"type":"string"}},"required":["message","user_id"],"type":"object"}}],"responses":{"200":{"description":"\u041e\u0442\u0432\u0435\u0442 \u0430\u0433\u0435\u043d\u0442\u0430","schema":{"$ref":"#/definitions/ChatResponse"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"502":{"description":"Upstream MCP \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041e\u0431\u0449\u0435\u043d\u0438\u0435 \u0441 AI-\u0430\u0433\u0435\u043d\u0442\u043e\u043c","tags":["agent"]}},"/v1/dictionaries":{"get":{"description":"\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0437\u0430\u0440\u0430\u043d\u0435\u0435 \u043f\u043e\u0441\u0447\u0438\u0442\u0430\u043d\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a\u043e\u0432 (`dictionaries`)\n\u043f\u043b\u044e\u0441 \u043e\u0431\u0449\u0435\u0435 \u0447\u0438\u0441\u043b\u043e \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439 (`cars_count`) \u0438 \u0432\u0440\u0435\u043c\u044f\n\u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u044f \u0441\u043d\u0430\u043f\u0448\u043e\u0442\u0430 (`updated_at`). \u0418\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u2014\n`frontend.company_filters`, \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043f\u0430\u0440\u0441\u0435\u0440\u043e\u043c \u0440\u0430\u0437 \u0432 \u0447\u0430\u0441.\n\n\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u043e\u0442\u0434\u0430\u0451\u0442 \u0431\u043b\u043e\u043a `locations` \u2014 \u0441\u0442\u0440\u0430\u043d\u044b (\u0438 \u0433\u043e\u0440\u043e\u0434\u0430 \u043f\u0440\u0438\n`?country=`) \u0441 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e\u043c \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439; \u044d\u0442\u043e\u0442 \u0431\u043b\u043e\u043a \u0440\u0430\u043d\u0435\u0435\n\u0436\u0438\u043b \u043d\u0430 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0439 \u0440\u0443\u0447\u043a\u0435 `/v1/locations` (\u0443\u0434\u0430\u043b\u0435\u043d\u0430; \u0432\u0441\u044f \u043b\u043e\u043a\u0430\u0446\u0438\u043e\u043d\u043d\u0430\u044f\n\u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u0442\u0435\u043f\u0435\u0440\u044c \u0437\u0434\u0435\u0441\u044c, **\u0441 \u0443\u0447\u0451\u0442\u043e\u043c `company_id`**).\n\n### \u041f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435 \u0432 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u043e\u0442 `company_id`\n\n| `company_id` | \u0427\u0442\u043e \u0432\u0435\u0440\u043d\u0451\u0442\u0441\u044f | HTTP |\n|---|---|---|\n| \u043d\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u043d / \u043f\u0443\u0441\u0442\u043e\u0439 / \u043d\u0435\u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u044b\u0439 UUID | **\u0413\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u044b\u0439** \u043d\u0430\u0431\u043e\u0440 (\u0432\u0435\u0441\u044c \u043a\u0430\u0442\u0430\u043b\u043e\u0433, \u0431\u0435\u0437 \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0439) | 200 |\n| \u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439 UUID, \u0434\u0438\u043b\u0435\u0440 \u043d\u0430\u0439\u0434\u0435\u043d | **\u0421\u043b\u043e\u0432\u0430\u0440\u0438 \u0434\u0438\u043b\u0435\u0440\u0430** \u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u0438\u0437 \u0435\u0433\u043e \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u044f | 200 |\n| \u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439 UUID, \u0434\u0438\u043b\u0435\u0440 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d | \u041f\u0443\u0441\u0442\u043e\u0439 \u043d\u0430\u0431\u043e\u0440 (`dictionaries: {}`, `cars_count: 0`). \u0421\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u043d\u043e \u0441 `cars_for_company(<unknown>)`, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0442\u043e\u0436\u0435 \u043e\u0442\u0434\u0430\u0451\u0442 0 | 200 |\n| \u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u0440\u043e\u043a\u0430 \u0432 `frontend.company_filters` \u043e\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u0435\u0442 (\u043f\u0430\u0440\u0441\u0435\u0440 \u043d\u0435 \u0437\u0430\u043f\u0438\u0441\u0430\u043b) | \u041e\u0448\u0438\u0431\u043a\u0430 | 404 |\n\n\u042d\u0442\u043e **\u0442\u043e \u0436\u0435** \u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435, \u0447\u0442\u043e \u0443 `/v1/cars` \u0441 `company_id` \u2014 \u043f\u0443\u0441\u0442\u043e\u0439 /\n\u043a\u0440\u0438\u0432\u043e\u0439 UUID \u043d\u0435 \u0432\u0430\u043b\u0438\u0442\u0441\u044f \u0432 400, \u0430 \u043c\u043e\u043b\u0447\u0430 \u043e\u0442\u0434\u0430\u0451\u0442 \u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u044b\u0439 \u043a\u0430\u0442\u0430\u043b\u043e\u0433.\n\u0422\u0430\u043a \u0441\u043b\u043e\u0432\u0430\u0440\u0438 \u0438 \u0441\u043f\u0438\u0441\u043e\u043a \u0430\u0432\u0442\u043e \u0432\u0441\u0435\u0433\u0434\u0430 \u0438\u0434\u0443\u0442 \u00ab\u0432 \u043d\u043e\u0433\u0443\u00bb.\n\n### \u0427\u0442\u043e \u0432\u043d\u0443\u0442\u0440\u0438 `dictionaries`\n\nJSONB-\u043e\u0431\u044a\u0435\u043a\u0442. \u041a\u043b\u044e\u0447\u0438 (\u043c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0435 \u0447\u0438\u0441\u043b\u043e \u2014 `brands`, \u043d\u0435 `brand`):\n\n**\u0421\u043f\u0438\u0441\u043a\u0438** (`[{slug, count, name_ru, name_en, ...}]`):\n\n- `vehicle_types` \u2014 `{slug, count, name_ru, name_en}`. \u0412\u0438\u0434\u0436\u0435\u0442\n  \u043e\u0442\u0440\u0438\u0441\u043e\u0432\u044b\u0432\u0430\u0435\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0442\u0435 \u0442\u0438\u043f\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0435\u0441\u0442\u044c \u0432 \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u0435.\n- `countries` \u2014 `{slug, count, name_ru, name_en, flag, flag_emoji}`,\n  \u0433\u0434\u0435 `flag` \u2014 URL \u043a\u0430\u0440\u0442\u0438\u043d\u043a\u0438 \u0444\u043b\u0430\u0433\u0430.\n- `brands` \u2014 `{slug, count, name_ru, name_en, logo}`,\n  \u0433\u0434\u0435 `logo` \u2014 \u043e\u0442\u043d\u043e\u0441\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0439 \u043f\u0443\u0442\u044c \u043a PNG-\u043b\u043e\u0433\u043e\u0442\u0438\u043f\u0443.\n- `body_types` \u2014 `{slug, count, name_ru, name_en}`.\n- `fuel_types`, `transmissions`, `drive_types` \u2014\n  `{slug, count, name_ru, name_en}`.\n- `colors` \u2014 `{slug, count, name_ru, name_en, hex}`.\n- `seller_types` \u2014 `{slug, count}` (\u0431\u0435\u0437 name_*).\n\n**\u0414\u0438\u0430\u043f\u0430\u0437\u043e\u043d\u044b** (`{min, max}`):\n\n- `years`, `mileage`, `price_rub`.\n\n\u0412\u0441\u0435 \u0441\u043f\u0438\u0441\u043a\u0438 \u0443\u0436\u0435 \u043e\u0442\u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u044b \u043f\u0430\u0440\u0441\u0435\u0440\u043e\u043c \u043f\u043e `count DESC`, \u043f\u043e\u044d\u0442\u043e\u043c\u0443\n\u0432\u0438\u0434\u0436\u0435\u0442 \u043c\u043e\u0436\u0435\u0442 \u0440\u0435\u043d\u0434\u0435\u0440\u0438\u0442\u044c \u0438\u0445 \u00ab\u043a\u0430\u043a \u0435\u0441\u0442\u044c\u00bb.\n\n### \u0411\u043b\u043e\u043a `locations`\n\n```\n\"locations\": {\n  \"countries\": [{name, cnt}],\n  \"cities\":    [{name, cnt, lat, lng}]\n}\n```\n\n\u0412\u043a\u043b\u044e\u0447\u0430\u0435\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0433\u043e\u0440\u043e\u0434\u0430 \u0441 \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u043c\u0438 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u0430\u043c\u0438 \u0432 `ref_cities` \u2014\n\u0442\u043e \u0436\u0435 \u043f\u043e\u0434\u043c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u043e, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u0440\u0438\u0441\u0443\u0435\u0442\u0441\u044f \u043d\u0430 \u043a\u0430\u0440\u0442\u0435 `/v1/cars-geo`.\n\u041c\u0430\u0441\u0441\u0438\u0432 `cities` \u0437\u0430\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u0438 `?country=<slug>`; \u0438\u043d\u0430\u0447\u0435\n\u044d\u0442\u043e \u043f\u0443\u0441\u0442\u043e\u0439 \u043c\u0430\u0441\u0441\u0438\u0432. \u041a\u043e\u0433\u0434\u0430 `company_id` \u0443\u043a\u0430\u0437\u0430\u043d \u0438 \u0432\u0430\u043b\u0438\u0434\u0435\u043d, \u0441\u0447\u0451\u0442\u0447\u0438\u043a\u0438\n`countries` / `cities` \u0441\u0447\u0438\u0442\u0430\u044e\u0442\u0441\u044f \u043f\u043e `frontend.cars_for_company(<uuid>)`.\n\n### \u041a\u043e\u0433\u0434\u0430 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c\n\n\u042d\u0442\u043e **\u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0443\u0435\u043c\u044b\u0439 \u0441\u043f\u043e\u0441\u043e\u0431** \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a\u0438 \u0434\u043b\u044f UI \u0432\u0438\u0434\u0436\u0435\u0442\u0430 \u2014\n\u043e\u0434\u043d\u043e\u0439 \u0440\u0443\u0447\u043a\u043e\u0439 \u0432\u043c\u0435\u0441\u0442\u043e \u0432\u044b\u0437\u043e\u0432\u043e\u0432 `/v1/brands`, `/v1/countries`,\n`/v1/vehicle-types` \u043f\u043e \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0441\u0442\u0438. \u0413\u043b\u0430\u0432\u043d\u044b\u0439 \u0432\u044b\u0438\u0433\u0440\u044b\u0448: \u0434\u043b\u044f \u0434\u0438\u043b\u0435\u0440\u0430\n(`company_id`) \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u0440\u043e\u0432\u043d\u043e \u0442\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\n\u043f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0442 \u0432 \u0435\u0433\u043e \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u0435, \u0431\u0435\u0437 \u00ab\u043f\u0443\u0441\u0442\u044b\u0445\u00bb \u043e\u043f\u0446\u0438\u0439 \u0432 \u0441\u0435\u043b\u0435\u043a\u0442\u043e\u0440\u0430\u0445.\n\n### \u041a\u044d\u0448\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435\n\n\u041e\u0442\u0432\u0435\u0442 \u043f\u043e\u043c\u0435\u0447\u0430\u0435\u0442\u0441\u044f `Cache-Control: public, max-age=3600` \u2014 \u0441\u043d\u0430\u043f\u0448\u043e\u0442\n\u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043d\u0435 \u0447\u0430\u0449\u0435 \u0440\u0430\u0437\u0430 \u0432 \u0447\u0430\u0441, \u0447\u0430\u0449\u0435 \u043e\u043f\u0440\u0430\u0448\u0438\u0432\u0430\u0442\u044c \u0441\u043c\u044b\u0441\u043b\u0430 \u043d\u0435\u0442.\n","parameters":[{"description":"UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438-\u0434\u0438\u043b\u0435\u0440\u0430. \u041d\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u043d / \u043f\u0443\u0441\u0442\u043e\u0439 / \u043d\u0435\u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u044b\u0439 \u2192\n\u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u044b\u0435 \u0441\u043b\u043e\u0432\u0430\u0440\u0438 (\u0432\u0435\u0441\u044c \u043a\u0430\u0442\u0430\u043b\u043e\u0433).\n","example":"3269aded-e5bd-4b33-b288-50d0c33b8945","in":"query","name":"company_id","required":false,"type":"string"},{"description":"\u0412\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0439 \u043a\u043e\u0434 \u0441\u0442\u0440\u0430\u043d\u044b (`russia`, `japan`, `china`, ...).\n\u0415\u0441\u043b\u0438 \u0437\u0430\u0434\u0430\u043d \u2014 `locations.cities` \u0437\u0430\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0441\u044f \u0433\u043e\u0440\u043e\u0434\u0430\u043c\u0438 \u044d\u0442\u043e\u0439\n\u0441\u0442\u0440\u0430\u043d\u044b (\u0441 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u0430\u043c\u0438). \u0415\u0441\u043b\u0438 \u043d\u0435 \u0437\u0430\u0434\u0430\u043d \u2014 `locations.cities`\n\u043f\u0443\u0441\u0442\u043e\u0439 \u043c\u0430\u0441\u0441\u0438\u0432.\n","example":"russia","in":"query","name":"country","required":false,"type":"string"},{"default":"car","description":"\u0422\u0438\u043f \u0442\u0440\u0430\u043d\u0441\u043f\u043e\u0440\u0442\u0430 \u0434\u043b\u044f \u0441\u0447\u0451\u0442\u0447\u0438\u043a\u043e\u0432 \u0432 `locations` (\u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `car`).\n\u041d\u0435 \u0432\u043b\u0438\u044f\u0435\u0442 \u043d\u0430 \u0441\u0430\u043c `dictionaries` \u2014 \u043e\u043d \u0431\u0435\u0440\u0451\u0442\u0441\u044f \u0438\u0437 \u0441\u043d\u0430\u043f\u0448\u043e\u0442\u0430.\n","in":"query","name":"vehicle_type","type":"string"}],"responses":{"200":{"description":"\u0421\u043b\u043e\u0432\u0430\u0440\u0438 (\u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u044b\u0435, \u0434\u0438\u043b\u0435\u0440\u0441\u043a\u0438\u0435 \u0438\u043b\u0438 \u043f\u0443\u0441\u0442\u044b\u0435)","schema":{"properties":{"cars_count":{"description":"\u0427\u0438\u0441\u043b\u043e \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439 \u0432 \u0441\u043d\u0430\u043f\u0448\u043e\u0442\u0435 (\u0434\u043b\u044f \u0434\u0438\u043b\u0435\u0440\u0430 \u2014\n\u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0433\u043e, \u0434\u043b\u044f \u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u2014 \u0432\u0441\u0435\u0433\u043e \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430).\n","example":1234,"type":"integer"},"dictionaries":{"description":"JSONB \u043a\u0430\u043a \u0435\u0441\u0442\u044c \u2014 \u0441\u043b\u043e\u0432\u0430\u0440\u0438 \u043f\u043e \u043a\u043b\u044e\u0447\u0430\u043c \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432\n(`brand`, `model`, `country`, `vehicle_type`, ...).\n\u041f\u0443\u0441\u0442\u043e\u0439 \u043e\u0431\u044a\u0435\u043a\u0442 `{}`, \u0435\u0441\u043b\u0438 `company_id` \u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439, \u043d\u043e\n\u043a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u0430.\n","type":"object"},"geo":{"description":"\u0413\u0435\u043e\u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a \u043d\u0430 \u043e\u0441\u043d\u043e\u0432\u0435 GeoNames (cities1000). \u0412 \u043e\u0442\u043b\u0438\u0447\u0438\u0435\n\u043e\u0442 `locations`, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0438\u0432\u044f\u0437\u0430\u043d \u043a \u0444\u0430\u043a\u0442\u0438\u0447\u0435\u0441\u043a\u043e\u043c\u0443 \u0438\u043d\u0432\u0435\u043d\u0442\u0430\u0440\u044e\n\u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430, `geo` \u2014 \u044d\u0442\u043e **\u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u044b\u0439** \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a \u0441\u0442\u0440\u0430\u043d \u0438\n\u043a\u0440\u0443\u043f\u043d\u044b\u0445 \u0433\u043e\u0440\u043e\u0434\u043e\u0432 \u0441\u043e \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u043c\u0438 `geonameid`. \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 \u0435\u0433\u043e\n\u0434\u043b\u044f UI-\u0441\u0435\u043b\u0435\u043a\u0442\u043e\u0440\u043e\u0432 \u00ab\u0421\u0442\u0440\u0430\u043d\u0430 \u2192 \u0413\u043e\u0440\u043e\u0434\u00bb \u0432 \u0444\u043e\u0440\u043c\u0435 \u0434\u043e\u0441\u0442\u0430\u0432\u043a\u0438/\u0430\u0434\u0440\u0435\u0441\u0430.\n\n\u041f\u043e\u0434\u0440\u043e\u0431\u043d\u0435\u0435 \u043f\u043e \u0433\u043e\u0440\u043e\u0434\u0430\u043c \u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442\u044b:\n`/v1/geo/cities/nearest` (\u043f\u043e \u0433\u0435\u043e\u043b\u043e\u043a\u0430\u0446\u0438\u0438),\n`/v1/geo/cities/top` (\u043f\u043e\u043b\u043d\u044b\u0439 \u0441\u043f\u0438\u0441\u043e\u043a pop>=100k \u0434\u043b\u044f \u0441\u0442\u0440\u0430\u043d\u044b),\n`/v1/geo/cities/search` (autocomplete).\n","properties":{"cities_top":{"description":"\u0421\u043f\u0438\u0441\u043e\u043a \u043a\u0440\u0443\u043f\u043d\u044b\u0445 \u0433\u043e\u0440\u043e\u0434\u043e\u0432 (`pop>=100k`) \u0434\u043b\u044f \u0441\u0442\u0440\u0430\u043d\u044b,\n\u0443\u043a\u0430\u0437\u0430\u043d\u043d\u043e\u0439 \u0432 `?country=<slug>`. \u0415\u0441\u043b\u0438 `country` \u043d\u0435\n\u043f\u0435\u0440\u0435\u0434\u0430\u043d \u2014 \u043f\u0443\u0441\u0442\u043e\u0439 \u043c\u0430\u0441\u0441\u0438\u0432 (\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435\n`/v1/geo/cities/top` \u0434\u043b\u044f \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0439 \u0441\u0442\u0440\u0430\u043d\u044b).\n","items":{"$ref":"#/definitions/GeoCity"},"type":"array"},"countries":{"description":"\u0412\u0441\u0435 \u0441\u0442\u0440\u0430\u043d\u044b \u0441 GeoNames-\u0433\u043e\u0440\u043e\u0434\u0430\u043c\u0438.","items":{"properties":{"cities_count":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u0433\u043e\u0440\u043e\u0434\u043e\u0432 \u0435\u0441\u0442\u044c \u0432 GeoNames \u0434\u043b\u044f \u044d\u0442\u043e\u0439 \u0441\u0442\u0440\u0430\u043d\u044b (>=1k \u0436\u0438\u0442\u0435\u043b\u0435\u0439).","example":4321,"type":"integer"},"cities_top_count":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u0433\u043e\u0440\u043e\u0434\u043e\u0432 \u0441 pop>=100k (\u043f\u043e\u043c\u0435\u0441\u0442\u044f\u0442\u0441\u044f \u0432 `cities_top` / `/v1/geo/cities/top`).","example":215,"type":"integer"},"flag_emoji":{"example":"\ud83c\uddf7\ud83c\uddfa","type":"string"},"flag_iso2":{"example":"RU","type":"string"},"iso2":{"example":"RU","type":"string"},"name":{"example":"\u0420\u043e\u0441\u0441\u0438\u044f","type":"string"},"name_en":{"type":"string"},"name_ru":{"type":"string"},"slug":{"description":"Slug \u0438\u0437 `ref_countries.code`, \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0435\u0442 \u0441 `country` \u0432 `/v1/cars`.","example":"russia","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"locations":{"description":"\u0421\u0442\u0440\u0430\u043d\u044b \u0438 \u0433\u043e\u0440\u043e\u0434\u0430 (\u0441 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u0430\u043c\u0438) \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430 \u2014 \u0437\u0430\u043c\u0435\u043d\u044f\u0435\u0442\n\u0443\u0434\u0430\u043b\u0451\u043d\u043d\u044b\u0439 `/v1/locations`. \u0423\u0447\u0438\u0442\u044b\u0432\u0430\u0435\u0442 `company_id`.\n","properties":{"cities":{"description":"\u041f\u0443\u0441\u0442\u043e\u0439 \u043c\u0430\u0441\u0441\u0438\u0432, \u0435\u0441\u043b\u0438 `country` \u043d\u0435 \u0437\u0430\u0434\u0430\u043d. \u0418\u043d\u0430\u0447\u0435 \u2014\n\u0433\u043e\u0440\u043e\u0434\u0430 \u0437\u0430\u0434\u0430\u043d\u043d\u043e\u0439 \u0441\u0442\u0440\u0430\u043d\u044b, \u043e\u0442\u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043f\u043e\n\u0443\u0431\u044b\u0432\u0430\u043d\u0438\u044e \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u0430.\n","items":{"properties":{"cnt":{"example":1421,"type":"integer"},"lat":{"example":55.755864,"type":"number"},"lng":{"example":37.617698,"type":"number"},"name":{"example":"\u041c\u043e\u0441\u043a\u0432\u0430","type":"string"}},"type":"object"},"type":"array"},"countries":{"items":{"properties":{"cnt":{"example":3245,"type":"integer"},"name":{"example":"russia","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"updated_at":{"description":"\u0412\u0440\u0435\u043c\u044f \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0435\u0433\u043e \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u044f \u0441\u043d\u0430\u043f\u0448\u043e\u0442\u0430. `null`, \u0435\u0441\u043b\u0438\n\u043a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u0430 (\u043f\u0443\u0441\u0442\u043e\u0439 \u043e\u0442\u0432\u0435\u0442).\n","example":"2026-05-07T12:00:00+00:00","format":"date-time","type":"string"}},"type":"object"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"404":{"description":"\u0413\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u0440\u043e\u043a\u0430 \u0432 `frontend.company_filters` \u0435\u0449\u0451 \u043d\u0435 \u0437\u0430\u043f\u0438\u0441\u0430\u043d\u0430\n\u043f\u0430\u0440\u0441\u0435\u0440\u043e\u043c (\u043f\u0435\u0440\u0432\u0438\u0447\u043d\u0430\u044f \u0438\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f). \u0414\u043e\u043b\u0436\u043d\u043e \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e\n\u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0441\u043b\u0435 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0439, \u043d\u0430 \u043f\u0440\u043e\u0434\u0435 \u043d\u0435 \u043e\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044f.\n","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u0421\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a\u0438 \u0434\u043b\u044f \u0432\u0438\u0434\u0436\u0435\u0442\u0430 (\u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u044b\u0435 \u0438\u043b\u0438 \u0434\u043b\u044f \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u0434\u0438\u043b\u0435\u0440\u0430)","tags":["catalog"]}},"/v1/dictionaries/brands/{brand}/models":{"get":{"parameters":[{"in":"path","name":"brand","required":true,"type":"string"},{"default":"car","in":"query","name":"vehicle_type","type":"string"}],"responses":{"200":{"description":"\u0421\u043f\u0438\u0441\u043e\u043a \u043c\u043e\u0434\u0435\u043b\u0435\u0439 \u0432\u044b\u0431\u0440\u0430\u043d\u043d\u043e\u0433\u043e \u0431\u0440\u0435\u043d\u0434\u0430 \u0441 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e\u043c, \u0434\u0438\u0430\u043f\u0430\u0437\u043e\u043d\u0430\u043c\u0438 \u0446\u0435\u043d \u0438 \u043f\u0440\u0438\u043c\u0435\u0440\u043e\u043c `photo`.\n"},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041c\u043e\u0434\u0435\u043b\u0438 \u0431\u0440\u0435\u043d\u0434\u0430","tags":["dictionaries"]}},"/v1/factories":{"get":{"description":"\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0432\u0441\u0435 \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0435 \u0430\u0432\u0442\u043e- \u0438 \u043c\u043e\u0442\u043e\u0437\u0430\u0432\u043e\u0434\u044b \u043f\u043e\u043f\u0443\u043b\u044f\u0440\u043d\u044b\u0445 \u043c\u0430\u0440\u043e\u043a \u0438\u0437 \u0440\u0435\u0435\u0441\u0442\u0440\u0430\n`factory` (\u043a\u0430\u0442\u0430\u043b\u043e\u0433) \u043a\u0430\u043a \u0442\u043e\u0447\u043a\u0438 \u0434\u043b\u044f \u043a\u0430\u0440\u0442\u044b (Yandex / Leaflet / Mapbox).\n\u041e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u043d\u0430\u0431\u043e\u0440 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432 \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u0437\u0434\u0435\u0441\u044c \u0438 \u0432\n`GET /v1/factories/stats` \u2014 \u043a\u0430\u0440\u0442\u0430 \u0438 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u00ab\u0438\u0434\u0443\u0442 \u0432 \u043d\u043e\u0433\u0443\u00bb.\n\n\u041a\u0430\u0436\u0434\u0430\u044f \u0442\u043e\u0447\u043a\u0430 \u043d\u0435\u0441\u0451\u0442 \u0438\u0434\u0435\u043d\u0442\u0438\u0447\u043d\u043e\u0441\u0442\u044c \u0437\u0430\u0432\u043e\u0434\u0430, \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b `lat`/`lng`, \u0433\u0440\u0443\u043f\u043f\u0443\n`oem_group`, \u0441\u0442\u0440\u0430\u043d\u0443, \u0433\u043e\u0434\u043e\u0432\u0443\u044e \u043c\u043e\u0449\u043d\u043e\u0441\u0442\u044c \u0438 \u0438\u043d\u043b\u0430\u0439\u043d-\u043c\u0430\u0441\u0441\u0438\u0432 `brands` (\u043c\u0430\u0440\u043a\u0438,\n\u0441\u043e\u0431\u0438\u0440\u0430\u0435\u043c\u044b\u0435 \u043d\u0430 \u0437\u0430\u0432\u043e\u0434\u0435). \u0422\u044f\u0436\u0451\u043b\u044b\u0439 \u0441\u043f\u0438\u0441\u043e\u043a `models` \u0432 \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u0435 **\u043e\u043f\u0443\u0449\u0435\u043d** \u2014\n\u043e\u043d \u0435\u0434\u0435\u0442 \u0432 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0435 `GET /v1/factories/{id}`.\n\n414 \u0437\u0430\u0432\u043e\u0434\u043e\u0432 \u043f\u043e\u043c\u0435\u0449\u0430\u044e\u0442\u0441\u044f \u0432 \u043e\u0434\u0438\u043d \u043e\u0442\u0432\u0435\u0442 \u2014 \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438 \u043d\u0435\u0442, \u043a\u043b\u0430\u0441\u0442\u0435\u0440\u0438\u0437\u0430\u0446\u0438\u044e\n\u0434\u0435\u043b\u0430\u0435\u0442 \u043a\u0430\u0440\u0442\u0430-\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u043d\u0430 \u043a\u043b\u0438\u0435\u043d\u0442\u0435. \u041a\u044d\u0448 \u043e\u0442\u0432\u0435\u0442\u0430 ~300 \u0441.\n","parameters":[{"description":"\u0422\u0438\u043f \u0442\u0440\u0430\u043d\u0441\u043f\u043e\u0440\u0442\u0430: `car`|`motorcycle`|`both`. CSV \u2014 \u0418\u041b\u0418 \u0432\u043d\u0443\u0442\u0440\u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430. \u0411\u0435\u0437 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 \u2014 \u0432\u0441\u0435 \u0442\u0438\u043f\u044b. \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u0432\u043d\u0435 \u043d\u0430\u0431\u043e\u0440\u0430 \u2192 400.","example":"car,both","in":"query","name":"vehicle_type","type":"string"},{"description":"ISO 3166-1 alpha-2 (\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u043e\u043d\u0435\u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e). CSV \u2014 \u0418\u041b\u0418 (\u0437\u0430\u0432\u043e\u0434\u044b \u043b\u044e\u0431\u043e\u0439 \u0438\u0437 \u0441\u0442\u0440\u0430\u043d).","example":"DE,JP","in":"query","name":"country","type":"string"},{"description":"\u0420\u043e\u0434\u0438\u0442\u0435\u043b\u044c\u0441\u043a\u0430\u044f OEM-\u0433\u0440\u0443\u043f\u043f\u0430 (\u0442\u043e\u0447\u043d\u043e\u0435 \u0441\u043e\u0432\u043f\u0430\u0434\u0435\u043d\u0438\u0435). CSV \u2014 \u0418\u041b\u0418.","example":"Toyota Group","in":"query","name":"oem_group","type":"string"},{"description":"Slug'\u0438 \u043c\u0430\u0440\u043e\u043a \u2014 \u0437\u0430\u0432\u043e\u0434\u044b, \u0433\u0434\u0435 \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u043b\u044e\u0431\u0430\u044f \u0438\u0437 \u043d\u0438\u0445. CSV \u2014 \u0418\u041b\u0418 (overlap).","example":"toyota,bmw","in":"query","name":"brand","type":"string"},{"description":"\u041c\u043e\u0434\u0435\u043b\u0438 \u0432 \u0442\u0435\u043a\u0443\u0449\u0435\u043c \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0441\u0442\u0432\u0435: slug \u0438\u043b\u0438 \u0447\u0430\u0441\u0442\u044c \u0438\u043c\u0435\u043d\u0438. \u0417\u0430\u0432\u043e\u0434 \u043f\u043e\u0434\u0445\u043e\u0434\u0438\u0442, \u0435\u0441\u043b\u0438 \u0432\u044b\u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u043b\u044e\u0431\u0443\u044e. CSV \u2014 \u0418\u041b\u0418.","example":"camry","in":"query","name":"model","type":"string"},{"description":"\u041e\u043a\u043d\u043e \u043a\u0430\u0440\u0442\u044b `min_lng,min_lat,max_lng,max_lat` (4 \u0447\u0438\u0441\u043b\u0430). \u0411\u0438\u0442\u044b\u0439 bbox \u2192 400.","example":"37.3,55.5,37.9,55.9","in":"query","name":"bbox","type":"string"}],"responses":{"200":{"description":"\u0417\u0430\u0432\u043e\u0434\u044b \u043a\u0430\u043a \u0442\u043e\u0447\u043a\u0438 \u043d\u0430 \u043a\u0430\u0440\u0442\u0443","schema":{"properties":{"count":{"description":"\u0421\u043a\u043e\u043b\u044c\u043a\u043e \u0437\u0430\u0432\u043e\u0434\u043e\u0432 \u043f\u043e\u0434 \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u043c (= \u0434\u043b\u0438\u043d\u0435 plants).","example":414,"type":"integer"},"plants":{"items":{"$ref":"#/definitions/FactoryPlant"},"type":"array"}},"type":"object"}},"400":{"description":"\u041d\u0435\u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439 \u0444\u0438\u043b\u044c\u0442\u0440 (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0431\u0438\u0442\u044b\u0439 bbox)","schema":{"$ref":"#/definitions/Error"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u0417\u0430\u0432\u043e\u0434\u044b \u043c\u0438\u0440\u0430 \u043a\u0430\u043a \u0442\u043e\u0447\u043a\u0438 \u043d\u0430 \u043a\u0430\u0440\u0442\u0443","tags":["factory"]}},"/v1/factories/stats":{"get":{"description":"\u0410\u0433\u0440\u0435\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u0430\u044f \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u043f\u043e \u0437\u0430\u0432\u043e\u0434\u0430\u043c \u043f\u043e\u0434 **\u0442\u0435\u043c \u0436\u0435** \u043d\u0430\u0431\u043e\u0440\u043e\u043c \u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432, \u0447\u0442\u043e\n`GET /v1/factories`: \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0432\u0441\u0435\u0433\u043e \u0437\u0430\u0432\u043e\u0434\u043e\u0432, \u0432 \u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u0441\u0442\u0440\u0430\u043d\u0430\u0445, \u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445\nOEM-\u0433\u0440\u0443\u043f\u043f, \u0441\u0443\u043c\u043c\u0430\u0440\u043d\u0430\u044f \u0433\u043e\u0434\u043e\u0432\u0430\u044f \u043c\u043e\u0449\u043d\u043e\u0441\u0442\u044c, \u043f\u043b\u044e\u0441 \u0440\u0430\u0437\u0431\u0438\u0432\u043a\u0438 `by_country`,\n`by_group`, `by_vehicle_type`.\n\n`total_plants` \u0432\u0441\u0435\u0433\u0434\u0430 \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0435\u0442 \u0441 `count` \u0438\u0437 `GET /v1/factories` \u043f\u0440\u0438 \u0442\u0435\u0445\n\u0436\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u0445. \u041a\u044d\u0448 \u043e\u0442\u0432\u0435\u0442\u0430 ~300 \u0441.\n","parameters":[{"description":"CSV `car`|`motorcycle`|`both` \u2014 \u0418\u041b\u0418. \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u0432\u043d\u0435 \u043d\u0430\u0431\u043e\u0440\u0430 \u2192 400.","example":"car,both","in":"query","name":"vehicle_type","type":"string"},{"description":"ISO alpha-2, CSV \u2014 \u0418\u041b\u0418.","example":"DE,JP","in":"query","name":"country","type":"string"},{"description":"OEM-\u0433\u0440\u0443\u043f\u043f\u0430, CSV \u2014 \u0418\u041b\u0418.","example":"Toyota Group","in":"query","name":"oem_group","type":"string"},{"description":"Slug'\u0438 \u043c\u0430\u0440\u043e\u043a, CSV \u2014 \u0418\u041b\u0418 (overlap).","example":"toyota,bmw","in":"query","name":"brand","type":"string"},{"description":"Slug \u0438\u043b\u0438 \u0447\u0430\u0441\u0442\u044c \u0438\u043c\u0435\u043d\u0438 \u043c\u043e\u0434\u0435\u043b\u0438, CSV \u2014 \u0418\u041b\u0418.","example":"camry","in":"query","name":"model","type":"string"},{"example":"37.3,55.5,37.9,55.9","in":"query","name":"bbox","type":"string"}],"responses":{"200":{"description":"\u0410\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u043f\u043e \u0437\u0430\u0432\u043e\u0434\u0430\u043c","schema":{"$ref":"#/definitions/FactoryStats"}},"400":{"description":"\u041d\u0435\u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439 \u0444\u0438\u043b\u044c\u0442\u0440","schema":{"$ref":"#/definitions/Error"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u0410\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u043f\u043e \u0437\u0430\u0432\u043e\u0434\u0430\u043c","tags":["factory"]}},"/v1/factories/{factory_id}":{"get":{"description":"\u041f\u043e\u043b\u043d\u0430\u044f \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u0437\u0430\u0432\u043e\u0434\u0430 \u043f\u043e \u0447\u0438\u0441\u043b\u043e\u0432\u043e\u043c\u0443 `id`: \u0432\u0441\u0435 \u043f\u043e\u043b\u044f \u0442\u043e\u0447\u043a\u0438 \u043a\u0430\u0440\u0442\u044b **\u043f\u043b\u044e\u0441**\n`brand_slugs` \u0438 `models` \u2014 \u0441\u043f\u0438\u0441\u043e\u043a `{brand, model, brand_slug, model_slug,\nvehicle_type}` \u043c\u043e\u0434\u0435\u043b\u0435\u0439, \u0432\u044b\u043f\u0443\u0441\u043a\u0430\u0435\u043c\u044b\u0445 \u043d\u0430 \u0437\u0430\u0432\u043e\u0434\u0435 \u0441\u0435\u0439\u0447\u0430\u0441.\n","parameters":[{"example":23,"in":"path","name":"factory_id","required":true,"type":"integer"}],"responses":{"200":{"description":"\u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u0437\u0430\u0432\u043e\u0434\u0430","schema":{"$ref":"#/definitions/FactoryPlant"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"404":{"description":"\u0417\u0430\u0432\u043e\u0434\u0430 \u0441 \u0442\u0430\u043a\u0438\u043c id \u043d\u0435\u0442","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u0437\u0430\u0432\u043e\u0434\u0430","tags":["factory"]}},"/v1/languages":{"get":{"description":"\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u044f\u0437\u044b\u043a\u043e\u0432 \u0438\u0437 `frontend.ref_languages`\n\u0432 \u043f\u043e\u0440\u044f\u0434\u043a\u0435 `sort_order, name_en`. \u041b\u0451\u0433\u043a\u0430\u044f \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0430\u044f \u0440\u0443\u0447\u043a\u0430 \u0434\u043b\u044f\n\u043f\u0435\u0440\u0435\u043a\u043b\u044e\u0447\u0430\u0442\u0435\u043b\u044f \u044f\u0437\u044b\u043a\u043e\u0432 \u2014 \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u0441\u0447\u0451\u0442\u0447\u0438\u043a\u043e\u0432 \u043f\u043e \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0443, \u043d\u0438\u043a\u0430\u043a\u0438\u0445\n\u0444\u0438\u043b\u044c\u0442\u0440\u043e\u0432.\n\n### \u041f\u043e\u043b\u044f\n\n- `code` \u2014 \u043a\u043e\u0434 \u044f\u0437\u044b\u043a\u0430 (ISO-639-1 / locale, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440 `ru`, `en`, `zh`).\n- `name` \u2014 \u043d\u0430\u0442\u0438\u0432\u043d\u043e\u0435 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, `\u0420\u0443\u0441\u0441\u043a\u0438\u0439`).\n- `name_en` \u2014 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0435 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435.\n- `flag_code` \u2014 ISO-3166-1 alpha-2 \u043a\u043e\u0434 \u0441\u0442\u0440\u0430\u043d\u044b \u0434\u043b\u044f \u0444\u043b\u0430\u0433\u0430 (`ru`, `gb`, ...).\n","responses":{"200":{"description":"\u0421\u043f\u0438\u0441\u043e\u043a \u044f\u0437\u044b\u043a\u043e\u0432","schema":{"items":{"properties":{"code":{"example":"ru","type":"string"},"flag_code":{"example":"ru","type":"string"},"name":{"example":"\u0420\u0443\u0441\u0441\u043a\u0438\u0439","type":"string"},"name_en":{"example":"Russian","type":"string"}},"type":"object"},"type":"array"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u042f\u0437\u044b\u043a\u0438 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u0430","tags":["dictionaries"]}},"/v1/search/parse":{"post":{"consumes":["application/json"],"description":"\u0411\u0435\u0440\u0451\u0442 \u0444\u0440\u0430\u0437\u0443 \u043d\u0430 \u0435\u0441\u0442\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u043c \u044f\u0437\u044b\u043a\u0435 (\u0440\u0443\u0441\u0441\u043a\u0438\u0439 / \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u0438\u0439 / \u0442\u0440\u0430\u043d\u0441\u043b\u0438\u0442)\n\u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 JSON \u0441 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u043c\u0438 \u0434\u043b\u044f \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430 \u2014 \u0442\u0435\u043c\u0438 \u0436\u0435 \u043f\u043e\u043b\u044f\u043c\u0438,\n\u0447\u0442\u043e \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 `/v1/cars`.\n\n**\u041f\u0440\u0438\u043d\u0446\u0438\u043f\u044b:**\n- \u0418\u0437\u0432\u043b\u0435\u043a\u0430\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u044f\u0432\u043d\u043e\u0435 / \u043e\u0434\u043d\u043e\u0437\u043d\u0430\u0447\u043d\u043e\u0435.\n- \u0411\u044e\u0434\u0436\u0435\u0442 \u043d\u0435 \u0443\u043f\u043e\u043c\u044f\u043d\u0443\u0442 \u2192 \u043f\u043e\u043b\u044f `min_price`/`max_price` \u043e\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0442. \u041d\u0435 \u0432\u044b\u0434\u0443\u043c\u044b\u0432\u0430\u0435\u043c.\n- \u00ab\u041d\u0435\u0434\u043e\u0440\u043e\u0433\u043e\u00bb / \u00ab\u043f\u0440\u0435\u043c\u0438\u0443\u043c\u00bb \u0431\u0435\u0437 \u0447\u0438\u0441\u0435\u043b \u2192 `ambiguity: true`, `missing: [\"price\"]`.\n- \u0426\u0435\u043d\u044b \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u0432 RUB \u043f\u043e \u043f\u043e\u043b\u044e `currency` \u0438\u0437 \u0437\u0430\u043f\u0440\u043e\u0441\u0430.\n- \u041f\u043e\u0432\u0442\u043e\u0440\u043d\u044b\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u044b \u0441 \u0442\u0435\u043c \u0436\u0435 \u0442\u0435\u043a\u0441\u0442\u043e\u043c \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442\u0441\u044f \u043c\u0433\u043d\u043e\u0432\u0435\u043d\u043d\u043e\n  (`cached: true` \u0432 \u043e\u0442\u0432\u0435\u0442\u0435).\n\n**\u041c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f (`\u0438\u043b\u0438` / `or` / `\u043b\u0438\u0431\u043e`):**\n\u0415\u0441\u043b\u0438 \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u043f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u0435\u043d\u043e \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u043e\u0432 \u0447\u0435\u0440\u0435\u0437 `\u0438\u043b\u0438`, `\u043b\u0438\u0431\u043e`\n\u0438\u043b\u0438 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0435 `or`, \u043f\u043e\u043b\u0435 \u0432 `filters` \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u043a\u0430\u043a **\u043c\u0430\u0441\u0441\u0438\u0432 \u0441\u0442\u0440\u043e\u043a**\n(\u0430 \u043d\u0435 \u0441\u0442\u0440\u043e\u043a\u0430). \u042d\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0434\u043b\u044f `brand`, `model`, `body_type`,\n`fuel_type`, `transmission`, `drive_type`, `country`, `color`.\n\u0427\u0438\u0441\u043b\u043e\u0432\u044b\u0435 \u0434\u0438\u0430\u043f\u0430\u0437\u043e\u043d\u044b (`min_*` / `max_*`) \u0441\u043b\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u043a\u0430\u043a \u043c\u0438\u043d\u0438\u043c\u0443\u043c/\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c\n\u043f\u043e \u0432\u0441\u0435\u043c \u0432\u0435\u0442\u043a\u0430\u043c.\n\n\u041f\u0440\u0438\u043c\u0435\u0440 \u0437\u0430\u043f\u0440\u043e\u0441\u0430 `\"bmw \u0438\u043b\u0438 kia 2020 \u0441\u0435\u0434\u0430\u043d \u0438\u043b\u0438 \u0443\u043d\u0438\u0432\u0435\u0440\u0441\u0430\u043b\"` \u2192\n```\n{\n  \"filters\": {\n    \"brand\": [\"BMW\", \"Kia\"],\n    \"body_type\": [\"\u0421\u0435\u0434\u0430\u043d\", \"\u0423\u043d\u0438\u0432\u0435\u0440\u0441\u0430\u043b\"],\n    \"min_year\": 2020\n  },\n  \"ambiguity\": false, \"missing\": [],\n  \"currency\": \"RUB\", \"mode\": \"auto\", \"cached\": false\n}\n```\n\u0412 `/v1/cars` \u043c\u0430\u0441\u0441\u0438\u0432\u044b \u043c\u043e\u0436\u043d\u043e \u043f\u0435\u0440\u0435\u0434\u0430\u0442\u044c \u043b\u0438\u0431\u043e \u043f\u043e\u0432\u0442\u043e\u0440\u0435\u043d\u0438\u0435\u043c \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\n(`?brand=BMW&brand=Kia`), \u043b\u0438\u0431\u043e \u0447\u0435\u0440\u0435\u0437 \u0437\u0430\u043f\u044f\u0442\u0443\u044e (`?brand=BMW,Kia`).\n\n**\u0413\u0435\u043e-\u043f\u043e\u0438\u0441\u043a (\u0442\u043e\u0447\u043a\u0430 + \u0440\u0430\u0434\u0438\u0443\u0441):**\n\u0424\u0440\u0430\u0437\u044b \u0432\u0438\u0434\u0430 \u00ab\u0440\u044f\u0434\u043e\u043c \u0441\u043e \u043c\u043d\u043e\u0439\u00bb, \u00ab\u0432 \u0440\u0430\u0434\u0438\u0443\u0441\u0435 50 \u043a\u043c \u043e\u0442 \u043c\u0435\u043d\u044f\u00bb,\n\u00ab\u043d\u0435 \u0434\u0430\u043b\u044c\u0448\u0435 100 \u043a\u043c \u043e\u0442 \u041c\u043e\u0441\u043a\u0432\u044b\u00bb, `near me`, `within 80 km of Moscow`\n\u0438\u0437\u0432\u043b\u0435\u043a\u0430\u044e\u0442\u0441\u044f \u0432 \u043f\u0430\u0440\u0443 \u043f\u043e\u043b\u0435\u0439 `near` + `radius_km` (\u0432\u0441\u0435\u0433\u0434\u0430 \u0432\u043c\u0435\u0441\u0442\u0435).\n`near` \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 \u0434\u0432\u0430 \u0444\u043e\u0440\u043c\u0430\u0442\u0430:\n- `\"@me\"` \u2014 sentinel; \u043a\u043b\u0438\u0435\u043d\u0442 \u0434\u043e\u043b\u0436\u0435\u043d \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b\n  \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f (TG `location`, browser geolocation, \u0446\u0435\u043d\u0442\u0440 \u043a\u0430\u0440\u0442\u044b).\n- `\"<lat>,<lng>\"` \u2014 \u0434\u0435\u0441\u044f\u0442\u0438\u0447\u043d\u044b\u0435 \u0433\u0440\u0430\u0434\u0443\u0441\u044b \u0447\u0435\u0440\u0435\u0437 \u0437\u0430\u043f\u044f\u0442\u0443\u044e (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440,\n  `\"55.755864,37.617698\"`).\n\n\u0420\u0430\u0434\u0438\u0443\u0441 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `50` \u043a\u043c \u0434\u043b\u044f \u0444\u0440\u0430\u0437 \u0431\u0435\u0437 \u044f\u0432\u043d\u043e\u0433\u043e \u0447\u0438\u0441\u043b\u0430.\n\n\u0413\u0435\u043e\u0444\u0438\u043b\u044c\u0442\u0440 \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u044e\u0442 `/v1/cars`, `/v1/chat`, `/v1/cars-geo` \u2014\n\u0438\u043c\u0435\u043d\u0430 \u043f\u043e\u043b\u0435\u0439 \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u044e\u0442, \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044c \u043f\u0435\u0440\u0435\u0441\u044b\u043b\u0430\u0435\u0442 \u043f\u0430\u0440\u0443 \u043a\u0430\u043a \u0435\u0441\u0442\u044c.\n`\"@me\"` \u0441\u0435\u0440\u0432\u0435\u0440 \u043d\u0435 \u0440\u0430\u0437\u0440\u0435\u0448\u0430\u0435\u0442: \u043d\u0430 \u044d\u0442\u043e\u0439 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 \u043d\u0435\u0442 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u043d\u043e\u0439\n\u0433\u0435\u043e\u043b\u043e\u043a\u0430\u0446\u0438\u0438, \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043a\u043b\u0438\u0435\u043d\u0442 \u043f\u0435\u0440\u0435\u0434 \u0432\u044b\u0437\u043e\u0432\u043e\u043c.\n\n\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u043f\u0435\u0440\u0435\u0434\u0430\u0442\u044c \u0432 GET `/v1/cars` \u0438\u043b\u0438\nPOST `/v1/chat` (\u0438\u043c\u0435\u043d\u0430 \u043f\u043e\u043b\u0435\u0439 \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u044e\u0442).\n","parameters":[{"in":"body","name":"body","required":true,"schema":{"properties":{"currency":{"default":"RUB","description":"\u0412\u0430\u043b\u044e\u0442\u0430, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u0443\u043a\u0430\u0437\u0430\u043d\u044b \u0446\u0435\u043d\u044b \u0432 `query`. \u041f\u0430\u0440\u0441\u0435\u0440 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u0443\u0435\u0442\n\u0438\u0442\u043e\u0433\u043e\u0432\u044b\u0435 `min_price`/`max_price` \u0432 RUB \u043f\u043e \u0444\u0438\u043a\u0441\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u043c\u0443 \u043a\u0443\u0440\u0441\u0443.\n","enum":["RUB","USD","EUR","CNY","KZT","BYN","GBP"],"example":"RUB","type":"string"},"mode":{"default":"auto","description":"\u0420\u0435\u0436\u0438\u043c \u043f\u0430\u0440\u0441\u0438\u043d\u0433\u0430:\n- `fast` \u2014 \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f \u0437\u0430\u0434\u0435\u0440\u0436\u043a\u0430, \u0431\u0430\u0437\u043e\u0432\u0430\u044f \u0442\u043e\u0447\u043d\u043e\u0441\u0442\u044c. \u0414\u043b\u044f\n  \u0438\u043d\u0442\u0435\u0440\u0430\u043a\u0442\u0438\u0432\u043d\u043e\u0433\u043e \u0432\u0432\u043e\u0434\u0430 / \u0430\u0432\u0442\u043e\u043a\u043e\u043c\u043f\u043b\u0438\u0442\u0430.\n- `auto` (\u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e) \u2014 \u0431\u0430\u043b\u0430\u043d\u0441 \u0441\u043a\u043e\u0440\u043e\u0441\u0442\u0438 \u0438 \u0442\u043e\u0447\u043d\u043e\u0441\u0442\u0438.\n- `quality` \u2014 \u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0442\u043e\u0447\u043d\u043e\u0441\u0442\u0438, \u0443\u0432\u0435\u043b\u0438\u0447\u0435\u043d\u043d\u0430\u044f \u0437\u0430\u0434\u0435\u0440\u0436\u043a\u0430.\n","enum":["fast","auto","quality"],"example":"auto","type":"string"},"query":{"description":"\u0421\u0432\u043e\u0431\u043e\u0434\u043d\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f. \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442 \u0440\u0430\u0437\u0434\u0435\u043b\u0438\u0442\u0435\u043b\u0438\n`\u0438\u043b\u0438` / `or` / `\u043b\u0438\u0431\u043e` \u0434\u043b\u044f \u043c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0445 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0439 \u2014\n\u043a\u0430\u0436\u0434\u044b\u0439 \u0432\u0430\u0440\u0438\u0430\u043d\u0442 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u043a\u0430\u043a \u044d\u043b\u0435\u043c\u0435\u043d\u0442 \u043c\u0430\u0441\u0441\u0438\u0432\u0430.\n","example":"bmw \u0438\u043b\u0438 kia 2020 \u0441\u0435\u0434\u0430\u043d \u0438\u043b\u0438 \u0443\u043d\u0438\u0432\u0435\u0440\u0441\u0430\u043b \u0434\u043e 3 \u043c\u043b\u043d","type":"string"},"use_cache":{"default":true,"description":"\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043a\u044d\u0448 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432. \u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e `true` \u2014 \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u044b\u0439\n\u0437\u0430\u043f\u0440\u043e\u0441 \u0441 \u0442\u0435\u043c \u0436\u0435 \u0442\u0435\u043a\u0441\u0442\u043e\u043c \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u043c\u0433\u043d\u043e\u0432\u0435\u043d\u043d\u043e (`cached: true`\n\u0432 \u043e\u0442\u0432\u0435\u0442\u0435). \u041f\u0435\u0440\u0435\u0434\u0430\u0439\u0442\u0435 `false`, \u0447\u0442\u043e\u0431\u044b \u043f\u0440\u0438\u043d\u0443\u0434\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u043f\u0435\u0440\u0435\u043f\u0430\u0440\u0441\u0438\u0442\u044c\n\u0437\u0430\u043f\u0440\u043e\u0441 \u0438 \u043d\u0435 \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432 \u043a\u044d\u0448.\n","example":true,"type":"boolean"},"vehicle_type":{"description":"\u0422\u0438\u043f \u0442\u0440\u0430\u043d\u0441\u043f\u043e\u0440\u0442\u0430 **\u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e**. \u041f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0441\u043b\u0438\n\u0441\u0430\u043c `query` \u043d\u0435 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u044f\u0432\u043d\u043e\u0433\u043e \u0443\u043f\u043e\u043c\u0438\u043d\u0430\u043d\u0438\u044f \u0442\u0438\u043f\u0430. \u0415\u0441\u043b\u0438 \u0432 \u0442\u0435\u043a\u0441\u0442\u0435\n\u0432\u0441\u0442\u0440\u0435\u0447\u0430\u0435\u0442\u0441\u044f \u00ab\u043c\u043e\u0442\u043e\u0446\u0438\u043a\u043b\u00bb / \u00ab\u043a\u0430\u0442\u0435\u0440\u00bb / \u00ab\u0441\u0430\u043c\u043e\u043b\u0451\u0442\u00bb \u0438 \u0442. \u0434., \u043f\u0430\u0440\u0441\u0435\u0440\n\u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u0432\u044b\u0431\u0435\u0440\u0435\u0442 \u0438\u0437\u0432\u043b\u0435\u0447\u0451\u043d\u043d\u044b\u0439 \u0442\u0438\u043f \u2014 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043a\u0430\u043a\n\u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0430, \u0430 \u043d\u0435 \u043a\u0430\u043a \u043f\u0440\u0438\u043d\u0443\u0434\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0439 \u0444\u0438\u043b\u044c\u0442\u0440.\n","enum":["car","motorcycle","jet_ski","atv","snowmobile","boat","yacht","aircraft","helicopter","rv","truck","construction"],"example":"car","type":"string"}},"required":["query"],"type":"object"}}],"responses":{"200":{"description":"\u0420\u0430\u0441\u043f\u0430\u0440\u0441\u0435\u043d\u043d\u044b\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u044b","schema":{"$ref":"#/definitions/ParsedFilters"}},"400":{"description":"\u041f\u0443\u0441\u0442\u043e\u0439 `query`","schema":{"$ref":"#/definitions/Error"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}},"502":{"description":"Upstream MCP \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041f\u0435\u0440\u0435\u0432\u043e\u0434 \u0441\u0432\u043e\u0431\u043e\u0434\u043d\u043e\u0433\u043e \u0442\u0435\u043a\u0441\u0442\u0430 \u0432 JSON-\u0444\u0438\u043b\u044c\u0442\u0440\u044b","tags":["catalog"]}},"/v1/sitemap/cars":{"get":{"description":"\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u044b \u0438 \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0435 URL'\u044b \u0430\u043a\u0442\u0438\u0432\u043d\u044b\u0445 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0439.\n\u0421\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043a\u0430 \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u0430\u044f \u2014 `id ASC`, \u0447\u0442\u043e\u0431\u044b \u043f\u0430\u0440\u0442\u043d\u0451\u0440 \u043c\u043e\u0433 \u043f\u0440\u043e\u0445\u043e\u0434\u0438\u0442\u044c\n\u043a\u0430\u0442\u0430\u043b\u043e\u0433 \u0447\u0430\u043d\u043a\u0430\u043c\u0438 \u043f\u043e 10 k \u0431\u0435\u0437 \u043f\u0440\u043e\u043f\u0443\u0441\u043a\u043e\u0432 \u0438 \u0434\u0443\u0431\u043b\u0435\u0439.\n\n\u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b:\n- `company_id` \u2014 UUID \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438; \u0443\u0447\u0438\u0442\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u0435\u0451 \u0444\u0438\u043b\u044c\u0442\u0440\u044b `car_filters`\n  (\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f `frontend.cars_for_company`). \u0411\u0435\u0437 \u043d\u0435\u0433\u043e \u2014 \u0432\u0435\u0441\u044c \u043a\u0430\u0442\u0430\u043b\u043e\u0433.\n- `since` \u2014 ISO-8601, \u0438\u043d\u043a\u0440\u0435\u043c\u0435\u043d\u0442\u0430\u043b\u044c\u043d\u0430\u044f \u0432\u044b\u0433\u0440\u0443\u0437\u043a\u0430 \u043f\u043e `created_at`.\n- `page` + `page_size` \u2014 \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u044f. `page_size` clamp \u0434\u043e 10 000.\n- `vehicle_type` \u2014 \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439 \u0444\u0438\u043b\u044c\u0442\u0440 \u0442\u0438\u043f\u0430 \u0442\u0440\u0430\u043d\u0441\u043f\u043e\u0440\u0442\u0430.\n\n\u041a\u0430\u0440\u0442\u043e\u0447\u043a\u0438 \u043d\u0430\u0440\u043e\u0447\u043d\u043e \u043b\u0438\u0448\u0435\u043d\u044b \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u044b\u0445 \u043f\u043e\u043b\u0435\u0439 (\u0431\u0440\u0435\u043d\u0434 / \u0446\u0435\u043d\u0430) \u2014 \u0434\u043b\u044f\nsitemap \u043d\u0443\u0436\u043d\u044b \u0442\u043e\u043b\u044c\u043a\u043e url + lastmod. \u0415\u0441\u043b\u0438 \u043f\u043e\u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044f \u043f\u043e\u043b\u043d\u044b\u0439 shape,\n\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 `/v1/cars` \u0441 \u0442\u0435\u043c\u0438 \u0436\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u0430\u043c\u0438.\n","parameters":[{"in":"query","name":"company_id","type":"string"},{"example":"2026-05-01T00:00:00Z","format":"date-time","in":"query","name":"since","type":"string"},{"default":1,"in":"query","minimum":1,"name":"page","type":"integer"},{"default":10000,"in":"query","maximum":10000,"minimum":1,"name":"page_size","type":"integer"},{"in":"query","name":"vehicle_type","type":"string"}],"responses":{"200":{"description":"\u0421\u0442\u0440\u0430\u043d\u0438\u0446\u0430 sitemap","schema":{"properties":{"cars":{"items":{"properties":{"id":{"example":12345,"type":"integer"},"lastmod":{"format":"date-time","type":"string"},"url":{"example":"https://proride.io/catalog/toyota/12345","type":"string"}},"type":"object"},"type":"array"},"company_id":{"format":"uuid","type":"string"},"has_more":{"example":true,"type":"boolean"},"page":{"example":1,"type":"integer"},"page_size":{"example":10000,"type":"integer"}},"type":"object"}},"401":{"description":"\u041d\u0435\u0442 \u0438\u043b\u0438 \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 X-API-Key","schema":{"$ref":"#/definitions/Error"}}},"summary":"\u041f\u043e\u0441\u0442\u0440\u0430\u043d\u0438\u0447\u043d\u0430\u044f \u0432\u044b\u0433\u0440\u0443\u0437\u043a\u0430 URL'\u043e\u0432 \u043b\u0438\u0441\u0442\u0438\u043d\u0433\u043e\u0432 \u0434\u043b\u044f sitemap","tags":["catalog"]}}},"produces":["application/json"],"schemes":["https"],"security":[{"ApiKeyAuth":[]}],"securityDefinitions":{"ApiKeyAuth":{"description":"\u041a\u043b\u044e\u0447 \u0434\u043e\u0441\u0442\u0443\u043f\u0430. \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0441\u044f \u0432 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u0430.","in":"header","name":"X-API-Key","type":"apiKey"}},"swagger":"2.0","tags":[{"description":"\u0412\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0435 \u0441 AI-\u0430\u0433\u0435\u043d\u0442\u043e\u043c (\u0447\u0430\u0442)","name":"agent"},{"description":"\u041f\u0440\u044f\u043c\u043e\u0439 \u0434\u043e\u0441\u0442\u0443\u043f \u043a \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0443: \u043f\u043e\u0438\u0441\u043a, \u0431\u0440\u0435\u043d\u0434\u044b, \u0434\u0435\u0442\u0430\u043b\u0438","name":"catalog"},{"description":"\u041a\u0430\u0440\u0442\u0430 \u043c\u0438\u0440\u043e\u0432\u044b\u0445 \u0430\u0432\u0442\u043e\u0437\u0430\u0432\u043e\u0434\u043e\u0432 + \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u043f\u043e \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0435\u043b\u044f\u043c","name":"factory"},{"description":"\u0421\u043b\u0443\u0436\u0435\u0431\u043d\u044b\u0435 \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442\u044b","name":"system"}]}