Manufacturability analysis as an API

Fast geometry-only pass. Sub-second on most parts. Metered under dfm.quick_info.

Request

curl -X POST https://digitalmetal.io/api/v1/dfm/quick-info \
  -H "X-API-Key: $DM_KEY" \
  -F "file=@part.step"

Response 200

{
  "geometry": {
    "volume_cm3": 124.50,
    "surface_area_cm2": 84.20,
    "bounding_box_mm": { "x": 48.30, "y": 32.10, "z": 21.60 }
  },
  "glb_url": "https://blob.vercel-storage.com/dfm/.../preview.glb",
  "stats": { "n_features": 320, "n_vertices": 38693, "n_triangles": 63960 }
}

Submit a full DFM analysis. Metered under dfm.analyze. Returns 202 with a job_id; poll GET /dfm/jobs/{id}, then read GET /dfm/jobs/{id}/result.

Form fields

• file — .step / .stp / .gltf / .glb, max 25 MB
• blob_url + filename — alternative to file; the backend fetches server-side
• quote_id (optional) — attach this analysis to an existing quote row
• max_edge (optional, default auto)
• curvature (optional, default auto)
• pull (optional, default cardinal) — cardinal | hemisphere | x,y,z
• alpha_min (deg, default 0.5) — undercut threshold
• alpha_warn (deg, default 3.0) — low-draft warning threshold

Response 202

{ "job_id": "ae91d057fa33", "status": "queued" }

Job status. Poll every 1–2 seconds.

{
  "job_id": "ae91d057fa33",
  "status": "queued" | "running" | "done" | "error",
  "error":  null | string,
  "filename": "part.step",
  "log": [ "...", "...", "..." ]
}

Full result: recognized features, every shipped module’s rule output, GLB URLs.

{
  "job_id": "ae91d057fa33",
  "status": "done",
  "features": {
    "roles_by_fid":   { "face_0007": 1, "face_0008": 4, ... },
    "role_names":     { "0": "Unclassified", "1": "Hole wall", ... },
    "features": [
      { "fid": "face_0007", "kind": "HOLE", "diameter_mm": 4.0,
        "depth_mm": 8.0, "related_fids": [...] },
      ...
    ],
    "manufacturability": {
      "pull_dir": [0, 0, 1], "alpha_min_deg": 0.5,
      "n_undercuts": 2, "n_low_draft": 4
    }
  },
  "modules": {
    "modules": [
      { "module_key": "cnc", "configurations": [
        { "configuration_key": "5-axis",
          "result": { "overall_severity": "warning",
                      "summary": { "pass": 7, "warning": 2, "fail": 0 },
                      "rules":   [ ... ] } } ] },
      ...
    ]
  },
  "artifacts": {
    "thickness_glb": "https://...",
    "clearance_glb": "https://...",
    "features_glb":  "https://...",
    "draft_glb":     "https://...",
    "features_json": "https://...",
    "modules_json":  "https://..."
  }
}

Re-run draft + recognition + modules with a new pull direction. Mesh is cached.

# pick a different pull
curl -X POST .../jobs/ae91d057fa33/recompute \
  -H "X-API-Key: $DM_KEY" \
  -F "pull=0,0,-1"

Catalog of selectors, metrics, comparison ops, RHS forms. Read this before authoring.

{
  "selector_sets": ["walls", "holes", "bosses", "fillets", "rounds",
                    "pockets", "slots", "fins", "all_features", ...],
  "metrics_per_feature": ["thickness.min", "thickness.mean", "draft.min",
                           "hole.diameter", "boss.height_over_diameter",
                           "axis_angle_to_pull", "area_mm2", ...],
  "metrics_whole_part":  ["part.thickness.cv", "part.undercut_count", ...],
  "comparison_ops": ["lt","le","gt","ge","eq","ne"],
  "severity_levels": ["pass","warning","fail"],
  "rhs_forms": [
    { "shape": "<number>", "doc": "literal" },
    { "shape": "{\"param\":\"<name>\"}", "doc": "configuration parameter" },
    { "shape": "{\"param\":\"<name>\",\"factor\":<x>}", "doc": "param × factor" }
  ]
}

Every shipped module spec, suitable for cloning + editing into a custom module.

Evaluate a caller-supplied module spec against a completed job. Same return shape as a single module entry in GET /jobs/{id}/result.

Request body (application/json)

{
  "module": {
    "key": "house",
    "name": "House DFM rules",
    "configurations": {
      "default": { "name": "Default", "parameters": { "min_wall_mm": 1.5 } }
    },
    "rules": [{
      "key": "min_wall",
      "name": "Minimum wall thickness",
      "scope": "per_feature",
      "selector": { "set": "walls" },
      "metric":   "thickness.min",
      "tiers": [
        { "level": "fail",    "op": "lt", "rhs": { "param": "min_wall_mm", "factor": 0.7 } },
        { "level": "warning", "op": "lt", "rhs": { "param": "min_wall_mm" } },
        { "level": "pass" }
      ],
      "messages": {
        "fail":    "{fid}: {metric:.2f} mm < {threshold:.2f} mm (severe)",
        "warning": "{fid}: {metric:.2f} mm < {threshold:.2f} mm",
        "pass":    "all {n_inspected} walls ≥ {threshold:.2f} mm"
      }
    }]
  },
  "configuration_key": "default",
  "overrides": { "min_wall_mm": 2.0 }
}