{"openapi":"3.1.0","info":{"title":"Phone Specs API","description":"电子产品规格查询 API — 手机品类","version":"1.0.0"},"paths":{"/":{"get":{"summary":"Root","description":"演示首页","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/health":{"get":{"summary":"Health","description":"健康检查","operationId":"health_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/stats":{"get":{"summary":"Stats","description":"数据统计","operationId":"stats_api_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/brands":{"get":{"summary":"Brands","description":"品牌列表","operationId":"brands_api_v1_brands_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/search":{"get":{"summary":"Search","description":"搜索手机 — 支持品牌、型号、芯片、系统等关键词\n\n示例:\n    /api/v1/search?q=iPhone\n    /api/v1/search?q=Snapdragon\n    /api/v1/search?q=华为&fields=id,brand,model,chipset,price_range","operationId":"search_api_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"搜索关键词（品牌/型号/芯片/系统）","title":"Q"},"description":"搜索关键词（品牌/型号/芯片/系统）"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回数量","default":20,"title":"Limit"},"description":"返回数量"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"返回字段（逗号分隔），默认全部","title":"Fields"},"description":"返回字段（逗号分隔），默认全部"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/specs/{phone_id}":{"get":{"summary":"Specs","description":"查询手机完整规格\n\n示例:\n    /api/v1/specs/apple_iphone16promax","operationId":"specs_api_v1_specs__phone_id__get","parameters":[{"name":"phone_id","in":"path","required":true,"schema":{"type":"string","title":"Phone Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/releases":{"get":{"summary":"Releases","description":"发布日历 — 按发布时间查询手机\n\n示例:\n    /api/v1/releases?year=2024\n    /api/v1/releases?year=2024&month=9\n    /api/v1/releases?brand=Apple\n    /api/v1/releases?year=2025&fields=id,brand,model,launch_date","operationId":"releases_api_v1_releases_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"按年份筛选（如 2024）","title":"Year"},"description":"按年份筛选（如 2024）"},{"name":"month","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":12,"minimum":1},{"type":"null"}],"description":"按月份筛选（1-12）","title":"Month"},"description":"按月份筛选（1-12）"},{"name":"brand","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"按品牌筛选","title":"Brand"},"description":"按品牌筛选"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回数量","default":50,"title":"Limit"},"description":"返回数量"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"返回字段（逗号分隔），默认全部","title":"Fields"},"description":"返回字段（逗号分隔），默认全部"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/image/{phone_id}":{"get":{"summary":"Image","description":"查询手机图片 URL\n\n示例:\n    /api/v1/image/apple_iphone16promax","operationId":"image_api_v1_image__phone_id__get","parameters":[{"name":"phone_id","in":"path","required":true,"schema":{"type":"string","title":"Phone Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/price/{phone_id}":{"get":{"summary":"Price","description":"查询手机价格区间（USD）\n\n示例:\n    /api/v1/price/apple_iphone16promax","operationId":"price_api_v1_price__phone_id__get","parameters":[{"name":"phone_id","in":"path","required":true,"schema":{"type":"string","title":"Phone Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compare":{"get":{"summary":"Compare","description":"对比两款手机规格\n\n示例:\n    /api/v1/compare?id1=apple_iphone16promax&id2=samsung_galaxys24ultra","operationId":"compare_api_v1_compare_get","parameters":[{"name":"id1","in":"query","required":true,"schema":{"type":"string","description":"第一款手机 ID","title":"Id1"},"description":"第一款手机 ID"},{"name":"id2","in":"query","required":true,"schema":{"type":"string","description":"第二款手机 ID","title":"Id2"},"description":"第二款手机 ID"}],"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"},"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"}}}}