{"openapi":"3.1.0","info":{"title":"ArmadaDetal Parts API","description":"Подбор и цены запчастей спецтехники (JCB и др.) по артикулу: наш прайс ArmadaDetal + рынок (оригинал / OEM / аналог). Для ИИ-ассистентов.","version":"1.0"},"paths":{"/v1/health":{"get":{"summary":"Проверка живости (без ключа)","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/llm":{"get":{"summary":"Пинг LLM: жив ли модельный слой (для мониторинга)","description":"Быстрая проверка, что LLM отвечает (просит модель сказать одно слово). Ключ нужен,\nлимит НЕ тратит. ok=true если модель ответила; ok=false + 503 если LLM недоступен.\nИдёт через тот же LLM-слой, что и агент — ловит блок RU-IP / падение прокси.","operationId":"health_llm_health_llm_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/price":{"post":{"summary":"Цена и наличие по артикулу","description":"Возвращает наш прайс (ArmadaDetal) + рыночные офферы (оригинал/OEM/аналог) по артикулу.","operationId":"v1_price_v1_price_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/price/{article}":{"get":{"summary":"Цена по артикулу (GET, артикул в пути)","operationId":"v1_price_get_v1_price__article__get","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"string","title":"Article"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/find":{"get":{"summary":"Поиск запчасти по названию (склад ArmadaDetal)","description":"Текстовый поиск по нашему складу, когда артикул неизвестен: «сальник полуоси JCB»,\n«фильтр масляный 3CX». Возвращает позиции с артикулами — дальше зовите /v1/price.","operationId":"v1_find_v1_find_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp":{"post":{"summary":"MCP endpoint (Claude / ChatGPT connectors)","operationId":"mcp_mcp_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PriceRequest":{"properties":{"article":{"type":"string","title":"Article","description":"Артикул запчасти (любой формат), напр. 320/04134 или 6106483M91"}},"type":"object","required":["article"],"title":"PriceRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}