{"openapi":"3.1.0","info":{"title":"Standard Machinist - Agentic CAD & Mechanical Engineering API","version":"1.0.0","description":"Headless API for AI agents and engineering platforms to programmatically configure, calculate engineering physics, quote manufacturing costs, and generate industrial OpenCASCADE STEP CAD models for standard mechanical components (springs, gears)."},"servers":[{"url":"https://www.standardmachinist.com","description":"Production Server"}],"paths":{"/api/v1/schema/{category}":{"get":{"summary":"Retrieve component parameter schemas","description":"Returns allowable parameter boundaries, types, step intervals, and dependency trees for standard mechanical objects.","parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string","enum":["springs","gears","all"]},"description":"Mechanical component category"}],"responses":{"200":{"description":"Machine-readable schema specification","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"attributes":{"type":"array"}}}}}}}}},"/api/v1/calculate":{"post":{"summary":"Real-time engineering physics & fatigue analysis","description":"Calculates stiffness rate, shear/bending stress, safety factors, fatigue life cycles, solid height, and resonance frequencies under load or deflection.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["springs","gears"],"default":"springs"},"specs":{"type":"object","properties":{"springType":{"type":"string","enum":["Compression","Tension","Torsion"]},"wireDiameter":{"type":"number","description":"Wire diameter in mm"},"outerDiameter":{"type":"number","description":"Outer diameter in mm"},"freeLength":{"type":"number","description":"Free length in mm"},"turns":{"type":"number","description":"Total turns / active coils"},"material":{"type":"string","enum":["Steel","Stainless Steel 304","Stainless Steel 316","Music Wire","Chrome Silicon Steel"]},"endType":{"type":"string","enum":["Squared","Squared & Ground","open","Machine/Extended Hook","Crossover Hook","Side Hook","Straight","90° Bend"]},"shotPeening":{"type":"string","enum":["Yes","No"]}},"required":["wireDiameter","outerDiameter","freeLength","turns"]},"testMode":{"type":"object","properties":{"inputMode":{"type":"string","enum":["load","deflection"],"default":"load"},"operatingLoad":{"type":"number","description":"Max operating load in N (or N·mm torque)"},"operatingDeflection":{"type":"number","description":"Max operating deflection in mm (or degrees)"},"preload":{"type":"number","description":"Preload in N or mm"}}}},"required":["category","specs"]}}}},"responses":{"200":{"description":"Comprehensive engineering analysis report"}}}},"/api/v1/quote":{"post":{"summary":"Parametric B2B manufacturing quote","description":"Calculates unit pricing, total order cost, setup cost amortization, and estimated production lead time for a given batch quantity.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","default":"springs"},"specs":{"type":"object"},"quantity":{"type":"integer","default":100}},"required":["category","specs","quantity"]}}}},"responses":{"200":{"description":"Parametric pricing quote with cost breakdown and lead times"}}}},"/api/v1/cad/step":{"post":{"summary":"Headless OpenCASCADE STEP CAD Generation","description":"Synthesizes physical 3D geometry using OpenCASCADE.js / Replicad and streams a standards-compliant ISO-10303-21 STEP CAD file.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"specs":{"type":"object","properties":{"springType":{"type":"string"},"wireDiameter":{"type":"number"},"outerDiameter":{"type":"number"},"freeLength":{"type":"number"},"turns":{"type":"number"},"endType":{"type":"string"},"pitch":{"type":"number"}},"required":["wireDiameter","outerDiameter","freeLength","turns"]}},"required":["specs"]}}}},"responses":{"200":{"description":"ISO-10303-21 STEP CAD Model File","content":{"application/step":{"schema":{"type":"string","format":"binary"}}}}}}}}}