{"openapi":"3.1.0","info":{"title":"Goo-net 日本汽车官方车型数据库 (Japan Vehicle Catalog API)","description":"提供 2006 年至今纯正日本汽车官方车型库检索服务，支持即时联想补全、多维物理属性筛选、谱系树状图与车型百科。","version":"4.0.0"},"paths":{"/sse":{"get":{"tags":["MCP"],"summary":"MCP Server-Sent Events (SSE) Proxy","description":"Proxies MCP SSE stream to the internal MCP server on port 8089.","operationId":"mcp_sse_proxy_sse_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/messages":{"get":{"tags":["MCP"],"summary":"MCP Messages Proxy","description":"Proxies MCP client messages to the internal MCP server on port 8089.","operationId":"mcp_messages_proxy_messages_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["MCP"],"summary":"MCP Messages Proxy","description":"Proxies MCP client messages to the internal MCP server on port 8089.","operationId":"mcp_messages_proxy_messages_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"options":{"tags":["MCP"],"summary":"MCP Messages Proxy","description":"Proxies MCP client messages to the internal MCP server on port 8089.","operationId":"mcp_messages_proxy_messages_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/suggest":{"get":{"tags":["Autocomplete"],"summary":"实时联想补全与智能搜索提示","description":"**超高速实时联想推荐 (Typeahead Suggestions)**：\n根据用户输入的任意字母、拼音、底盘代号前缀或中文名称（如 `vo` -> 沃克西 VOXY / 大众 VOLKSWAGEN / 特斯拉 TESLA），\n在 <3ms 内返回智能分类建议，支持一键直达谱系树、Wiki、配置对比或筛选。","operationId":"suggest_entities_api_v1_suggest_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"输入任意前缀或关键词，如 vo, alp, zwr, 沃, 皇冠, toyota, tesla...","title":"Q"},"description":"输入任意前缀或关键词，如 vo, alp, zwr, 沃, 皇冠, toyota, tesla..."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats":{"get":{"tags":["System"],"summary":"获取数据库全量统计信息","operationId":"get_stats_api_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/seenew":{"get":{"tags":["Catalog Search"],"summary":"SEENEW 指令：查询最新上市发布的车型","operationId":"see_new_vehicles_api_v1_seenew_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"maker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Maker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/lookup/{chassis_code}":{"get":{"tags":["Universal Lookup"],"summary":"万能多功能反查（型式 / 车型 / 品牌）","operationId":"lookup_by_chassis_api_v1_lookup__chassis_code__get","parameters":[{"name":"chassis_code","in":"path","required":true,"schema":{"type":"string","title":"Chassis Code"}},{"name":"include_grades","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Grades"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/filter":{"get":{"tags":["Multi-Dimensional Filter"],"summary":"多维度复合属性筛选","operationId":"filter_vehicles_api_v1_filter_get","parameters":[{"name":"maker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Maker"}},{"name":"drive","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Drive"}},{"name":"capacity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capacity"}},{"name":"doors","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doors"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Year"}},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Year"}},{"name":"engine","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engine"}},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transmission"}},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keyword"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/facelifts/search":{"get":{"tags":["Facelift"],"summary":"改款说明全文检索","operationId":"search_facelifts_api_v1_facelifts_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"}},{"name":"maker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Maker"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/timeline/{model_keyword}":{"get":{"tags":["Timeline"],"summary":"车型世代时间线","operationId":"get_model_timeline_api_v1_timeline__model_keyword__get","parameters":[{"name":"model_keyword","in":"path","required":true,"schema":{"type":"string","title":"Model Keyword"}},{"name":"maker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Maker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compare/{target}":{"get":{"tags":["Comparison"],"summary":"横向配置比对","operationId":"compare_grades_api_v1_compare__target__get","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tree/model/{model_keyword}":{"get":{"tags":["Tree View"],"summary":"车型谱系树状图","operationId":"get_model_tree_api_api_v1_tree_model__model_keyword__get","parameters":[{"name":"model_keyword","in":"path","required":true,"schema":{"type":"string","title":"Model Keyword"}},{"name":"max_grades","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":0,"default":4,"title":"Max Grades"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wiki/{model_keyword}":{"get":{"tags":["Vehicle Wiki"],"summary":"车型百科档案","operationId":"get_model_wiki_api_api_v1_wiki__model_keyword__get","parameters":[{"name":"model_keyword","in":"path","required":true,"schema":{"type":"string","title":"Model Keyword"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/makers":{"get":{"tags":["Catalog Search"],"summary":"获取所有车厂及统计","operationId":"list_makers_api_v1_makers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/family/{target}":{"get":{"tags":["Family Matrix"],"summary":"查询车系家族母族与孪生姐妹车全景矩阵","description":"**车系家族母系与孪生姐妹车全景伞状矩阵 (Vehicle Family & Sister Hub)**：\n支持输入 family_id（如 `toyota_corolla_family`, `toyota_noah_voxy_esquire`）、\n车型代码（如 `COROLLA_CROSS`, `VOXY`, `VELLFIRE`, `86`, `BRZ`）、\n日文/中文名（如 `カローラ`, `埃尔法`, `皇冠`）或底盘代码（如 `AAHH40W`, `MZRA90W`, `ZVG11`），\n一键返回全家族同源车系、各代分组、跨车型共享屏幕规格、通用配件互通范围与亚马逊高转化连写词。","operationId":"get_family_matrix_api_v1_family__target__get","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/families":{"get":{"tags":["Family Matrix"],"summary":"获取所有已收录车系家族及统计","description":"获取系统中收录的全部汽车家族与OEM双生换标姐妹车群列表，包含世代划分与涵盖车型汇总。","operationId":"list_vehicle_families_api_v1_families_get","parameters":[{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"按类型筛选: LINEAGE_DERIVATIVE, OEM_TWIN_SISTERS, PLATFORM_SIBLINGS","title":"Type"},"description":"按类型筛选: LINEAGE_DERIVATIVE, OEM_TWIN_SISTERS, PLATFORM_SIBLINGS"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sync":{"post":{"tags":["System"],"summary":"触发增量自动更新","operationId":"trigger_sync_api_v1_sync_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}