{"openapi": "3.1.0", "info": {"title": "上海馨祥合金材料有限公司 电热合金数据 API", "version": "1.0.0", "description": "电热合金与精密电阻合金牌号的公开只读数据接口。面向 AI Agent、搜索引擎与工程计算场景，无需鉴权，全部 GET，允许跨域。", "contact": {"name": "上海馨祥合金材料有限公司", "url": "https://www.shdianresi.com"}, "x-updated": "2026-10-17"}, "servers": [{"url": "https://www.shdianresi.com"}], "paths": {"/api/v1/grades": {"get": {"summary": "全部牌号", "description": "返回全部牌号的精简列表", "responses": {"200": {"description": "OK"}}}}, "/api/v1/compare": {"get": {"summary": "牌号对比", "description": "并排对比 2~4 个牌号的耐温、电阻率、合金体系", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "grades", "in": "query", "required": true, "schema": {"type": "string"}, "description": "逗号分隔的牌号 id，2~4 个，如 0cr25al5,cr20ni80", "example": "0cr25al5,cr20ni80"}]}}, "/api/v1/grade/{id}": {"get": {"summary": "单个牌号", "description": "按 id 或牌号名返回完整数据", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}, "description": "牌号 id 或名称，如 cr20ni35"}], "responses": {"200": {"description": "OK"}}}}, "/api/v1/convert": {"get": {"summary": "牌号换算", "description": "国外或商品名 → 国标牌号。例 Ni40Cr20 → Cr20Ni35", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "q", "in": "query", "required": true, "description": "国外牌号或商品名，如 Ni40Cr20、Nichrome、Kanthal A-1", "schema": {"type": "string"}}]}}, "/api/v1/select": {"get": {"summary": "按工况选型", "description": "按工作温度与气氛推荐牌号，并给出含硫禁用等安全提示", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "temp", "in": "query", "required": true, "description": "元件工作温度（℃），不是炉温", "schema": {"type": "number"}}, {"name": "atmosphere", "in": "query", "required": false, "description": "气氛：air / sulfur / carburizing / vacuum / reducing", "schema": {"type": "string"}}]}}, "/api/v1/calc/sheet-resistance": {"get": {"summary": "方阻计算", "description": "Rs (Ω/□) = ρ ÷ t ÷ 1000", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "rho", "in": "query", "required": true, "description": "电阻率（μΩ·m），如 1.40", "schema": {"type": "number"}}, {"name": "t", "in": "query", "required": true, "description": "厚度（mm），如 1.0", "schema": {"type": "number"}}, {"name": "w", "in": "query", "required": false, "description": "宽度（mm），可选，用于换算每米电阻", "schema": {"type": "number"}}]}}, "/api/v1/calc/length": {"get": {"summary": "长度反算", "description": "L(mm) = R × w ÷ Rs", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "rho", "in": "query", "required": true, "description": "电阻率（μΩ·m）", "schema": {"type": "number"}}, {"name": "t", "in": "query", "required": true, "description": "厚度（mm）", "schema": {"type": "number"}}, {"name": "w", "in": "query", "required": true, "description": "宽度（mm）", "schema": {"type": "number"}}, {"name": "R", "in": "query", "required": true, "description": "目标电阻（Ω）", "schema": {"type": "number"}}]}}, "/api/v1/calc/component": {"get": {"summary": "元件电阻与功率", "description": "R1 = ρ÷A；R = R1×L；P = U²÷R；W = P÷S；元件温度 ≈ 炉温 + W×70", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "grade", "in": "query", "required": false, "description": "牌号 id，如 0cr25al5（与 rho 二选一）", "schema": {"type": "string"}}, {"name": "rho", "in": "query", "required": false, "description": "电阻率（μΩ·m），可替代 grade", "schema": {"type": "number"}}, {"name": "form", "in": "query", "required": false, "description": "wire 丝 / strip 带，默认 wire", "schema": {"type": "string"}}, {"name": "d", "in": "query", "required": false, "description": "丝径（mm），form=wire 时必填", "schema": {"type": "number"}}, {"name": "w", "in": "query", "required": false, "description": "带宽（mm），form=strip 时必填", "schema": {"type": "number"}}, {"name": "t", "in": "query", "required": false, "description": "带厚（mm），form=strip 时必填", "schema": {"type": "number"}}, {"name": "L", "in": "query", "required": true, "description": "长度（m）", "schema": {"type": "number"}}, {"name": "U", "in": "query", "required": true, "description": "电压（V）", "schema": {"type": "number"}}, {"name": "furnace", "in": "query", "required": false, "description": "炉膛温度（℃），用于估算元件温度与余量", "schema": {"type": "number"}}]}}, "/api/v1/calc/thermocouple": {"get": {"summary": "热电偶回路电阻", "description": "R1 (Ω/m) = (ρ+ + ρ−) ÷ A，A = π×d²÷4", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "type", "in": "query", "required": true, "description": "分度号：k / e / j / t / n / s", "schema": {"type": "string"}}, {"name": "d", "in": "query", "required": true, "description": "偶丝直径（mm），如 0.5", "schema": {"type": "number"}}, {"name": "L", "in": "query", "required": true, "description": "长度（m）", "schema": {"type": "number"}}]}}, "/api/v1/anneal": {"get": {"summary": "软化退火温度", "description": "返回 17 个常用牌号的软化退火区间、保温时间与气氛要求", "responses": {"200": {"description": "OK"}}, "parameters": [{"name": "grade", "in": "query", "required": true, "description": "牌号 id，如 cr20ni80", "schema": {"type": "string"}}]}}, "/api/v1/spec/{id}": {"get": {"summary": "可供规格", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "OK"}}}}, "/api/v1/quote": {"post": {"summary": "结构化询价（面向 AI Agent）", "description": "把询价需求以结构化 JSON 提交，返回受理编号。**不返回价格** —— 工业品需人工核价，报价答复为 1 个工作日。定价与交货规则见 /pricing.md。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["form", "contact"], "properties": {"grade": {"type": "string", "description": "牌号，如 0Cr25Al5；不确定填 unknown 并在 note 说明用途"}, "form": {"type": "string", "enum": ["wire", "strip", "part"], "description": "形态：wire 丝 / strip 带 / part 成型件"}, "diameter_mm": {"type": "number", "description": "丝径（mm）"}, "width_mm": {"type": "number", "description": "带宽（mm）"}, "thickness_mm": {"type": "number", "description": "带厚（mm）"}, "quantity_kg": {"type": "number", "description": "数量（kg）"}, "quantity_pcs": {"type": "number", "description": "数量（件），成型件用"}, "temperature_c": {"type": "number", "description": "元件使用温度（℃），不是炉温"}, "atmosphere": {"type": "string", "enum": ["air", "sulfur", "carburizing", "vacuum", "reducing"]}, "target_resistance_ohm": {"type": "number", "description": "目标电阻（Ω）"}, "tolerance": {"type": "string", "description": "公差要求"}, "delivery_city": {"type": "string", "description": "交货省市（影响运费）"}, "name": {"type": "string", "description": "称呼"}, "company": {"type": "string", "description": "单位名称"}, "contact": {"type": "string", "description": "手机号或邮箱（必填）"}, "note": {"type": "string", "maxLength": 500, "description": "补充说明"}, "test": {"type": "boolean", "description": "测试模式：true 时字段校验照走，但不写入线索台账、不推送通知。开发联调用，不要用于真实询价。"}}}}}}, "responses": {"200": {"description": "已受理，返回 ticket"}, "400": {"description": "参数缺失或格式错误"}, "429": {"description": "请求过于频繁"}}}}}}