MechanixCalc API

// Example: Gear analysis via fetch
const response = await fetch("https://www.mechanixcalc.com/api/v1/gears", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    mn: 3,
    z1: 20,
    z2: 60,
    b: 30,
    beta: 15,
    x1: 0,
    x2: 0,
    material: "16MnCr5",
    rpm1: 1500,
    power: 10,
    qualityGrade: 7,
  }),
});

const data = await response.json();
console.log(data.result.SF1);  // Pinion root safety factor
console.log(data.result.SH);   // Contact safety factor

// Example: Bolt joint analysis
const response = await fetch("https://www.mechanixcalc.com/api/v1/bolts", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    threadSize: "M12",
    propertyClass: "10.9",
    quantity: 4,
    frictionCoeff: 0.12,
    tighteningMethod: "torque-wrench",
    externalAxialLoad: 20000,
    externalShearLoad: 5000,
    jointStiffnessRatio: 0.2,   // used only when joint.usePhi = "manual" or no joint is sent
    preloadScatter: 25,
    safetyRequired: 1.5,
    // Joint geometry: the load factor comes from it (VDI 2230-1 §5.1) and so does
    // the preload lost to embedding (§5.4.2.1). Omit it and the response says so —
    // the clamp-side numbers are then optimistic.
    joint: {
      clampLengthMm: 40,
      shankLengthMm: 0,
      jointType: "through",     // or "tapped"
      headType: "hex",          // or "socket"
      roughness: "medium",      // Rz <10 "fine" / 10-40 "medium" / 40-160 "coarse"
      interfaces: 1,            // plate-to-plate joints inside the clamp
      usePhi: "computed",       // or "manual"
      // optional: bearingDiaMm, holeDiaMm, outerDiaMm, plateEmod
    },
  }),
});

const data = await response.json();
console.log(data.result.tighteningTorque); // N·m
console.log(data.result.safetyYield);      // Safety factor vs yield