Instant Quote Engine

Headless CNC quoting service for the Axton Robotics platform. Send a STEP file; get back measured geometry and display meshes, priced options (material, tolerance, finish, quantity, lead time), engineer-review flags, and a branded PDF. All geometry analysis and pricing run inside this service — responses carry prices, never rates.

CopyBase URL: https://quote.axton.tools/api/v1

Requests and responses are JSON, with two exceptions: POST /quotes takes multipart/form-data, and POST /quotes/{id}/pdf returns application/pdf bytes.

Authentication

Every request (except /health) needs a service key issued by Axton. Send it as a Bearer token in the Authorization header. Keys are configured server-side (SERVICE_API_KEYS, comma-separated so a new key can be rotated in while the old one still works) and must stay on your backend — never in client-side code.

Copycurl -H "Authorization: Bearer axq_YOUR_KEY" \
  "https://quote.axton.tools/api/v1/catalog"

A missing or invalid key returns 401 with {"error": "Missing or invalid service key."}.

Quoting flow

3D viewer component

The engine's repo ships a drop-in React component — integration/react/PartViewer.tsx — that renders the mesh payload from POST /quotes with the same studio look as the original portal: orbit/pan/zoom, per-material appearance from the catalog's visual settings, click-to-pick for multi-body files, and captureThumbnail() for the PDF step. See integration/README.md for the Laravel proxy sketch and Next.js wiring (peer dep: three).

Liveness probe — the only unauthenticated endpoint. Returns {"ok": true, "store": "postgres"}.

The authoritative list of option keys and display names — materials, tolerances, finishes, lead times — plus per-material 3D appearance settings. It changes only when the shop edits rates, so cache it and serve it to your frontend from your own endpoint. See Catalog values for the shape and current keys.

Uploads one or more STEP files as multipart/form-data. Each file is validated, parsed in an isolated worker with a hard timeout, measured and stored. Returns a display mesh per solid body for the 3D preview.

Response 200

Copy{
  "quoteId": "AXQ-260827-4F2A",
  "meta": { "userId": 184 },
  "parts": [
    {
      "partId":    "9f2c1a7b3d4e5f60",
      "fileName":  "bracket.step",
      "needsPick": false,            // true when the file holds >1 body
      "bodies": [
        {
          "bodyIndex": 0,
          "position":  [0, 0, 0, /* flat XYZ vertex array */],
          "normal":    [0, 1, 0, /* … or null if absent */],
          "index":     [0, 1, 2, /* triangle indices */],
          "geo": {
            "volumeMm3": 48210.4,
            "areaMm2":   15320.8,
            "bbox":      { "x": 120.0, "y": 80.0, "z": 25.0 },
            "triangles": 4820,
            "faces":     86,
            "bodies":    1
          }
        }
      ]
    }
  ],
  "failed": ["corrupt-model.stp"]     // files that could not be read
}

All dimensions are millimetres, taken from the STEP file's own units. Errors: 400 no files / bad meta · 404 unknown quoteId · 422 nothing readable as STEP · 500 parse or storage failure.

The stored record: createdAt, meta, and each part's partId/fileName/needsPick with per-body geo. No mesh arrays — for re-rendering a part later, re-upload it. 404 if unknown.

Prices the given selections against the stored geometry. Cheap and idempotent — call it on every option change. Debounce in the UI: the per-key rate budget is shared by the whole site.

Selection object

Response 200

Copy{
  "quoteId": "AXQ-260827-4F2A",
  "orderTotal": 1428.70,          // sum of clean (no-review) line totals
  "results": [
    {
      "partId":    "9f2c1a7b3d4e5f60",
      "bodyIndex": 0,
      "needsPick": false,
      "quote": {
        "unit":      142.87,        // per-part price, all multipliers applied
        "total":     1428.70,
        "qty":       10,
        "cycleMin":  18.4,          // estimated machining minutes per part
        "leadDays":  10,
        "leadName":  "Standard · 10 days",
        "matName":   "Aluminum 6061-T6",
        "tolName":   "Std ±0.125 mm",
        "finName":   "As machined",
        "qtyFactor":  0.94,         // volume discount applied
        "leadFactor": 1.0,          // lead-time multiplier applied
        "minOrderApplied": false,
        "comp": {                        // per-part breakdown, already marked up
          "machining": 98.20,       // cutting + setup amortised over qty
          "material":  44.67,
          "finishing": 0
        }
      },
      "review": []
    }
  ]
}

Two result shapes need special handling

Errors: 404 unknown quote · 500 pricing failure.

Builds the branded PDF, stores a copy, and returns the bytes (Content-Type: application/pdf, attachment named after the quote). It re-prices internally from the same selections, so the PDF always matches what the engine would quote — prices cannot be injected.

Errors: 404 unknown quote · 500 generation failure. A failure to store the copy is logged but the bytes are still returned.

The engine keeps every uploaded STEP file and the latest generated PDF per quote — this is how the shop retrieves CAD for manufacturing after an order is placed.

Catalog values

Shape of GET /catalog. Build selectors from the live response rather than hard-coding the tables below — the shop adds materials and finishes without notice.

Copy{
  "catalog": {
    "company": "Axton Robotics",
    "website": "axtonrobotics.com",
    "quoteValidDays": 30,
    "materials": {
      "al-6061": {
        "name":  "Aluminum 6061-T6",
        "group": "aluminum",
        "visual": { "color": 13160914, "metalness": 0.95, "roughness": 0.4 }
      }
    },
    "tolerances": { "std": { "name": "Std ±0.125 mm" } },
    "finishes":   { "anodize-clr": { "name": "Anodize clear", "groups": ["aluminum"] } },
    "leadTimes":  { "standard": { "name": "Standard · 10 days", "days": 10 } }
  }
}

visual feeds the viewer's material appearance (color is a decimal RGB integer) — pass it to PartViewer as materialVisual.

Field reference

geo — measured geometry

quote — pricing result

Errors & limits

Every error body is JSON: {"error": "Human-readable message."}

Limits

Full example

A complete quote in four server-to-server calls.

Copy# 0 — option catalog (cache it)
curl -s -H "Authorization: Bearer axq_YOUR_KEY" \
  https://quote.axton.tools/api/v1/catalog

# 1 — upload a STEP file (form field: "files"; optional meta JSON)
curl -s -H "Authorization: Bearer axq_YOUR_KEY" \
  -F 'files=@bracket.step' \
  -F 'meta={"userId":184}' \
  https://quote.axton.tools/api/v1/quotes
# → {"quoteId":"AXQ-260827-4F2A","parts":[{"partId":"9f2c…", …}],"failed":[]}

# 2 — price it
curl -s -H "Authorization: Bearer axq_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "leadtime": "standard",
        "selections": [
          { "partId": "9f2c…", "material": "al-6061",
            "tolerance": "std", "finish": "as-machined", "qty": 10 }
        ]
      }' \
  https://quote.axton.tools/api/v1/quotes/AXQ-260827-4F2A/price
# → {"quoteId":"…","orderTotal":1428.70,"results":[{"quote":{…},"review":[]}]}

# 3 — build + download the PDF (thumbs come from PartViewer.captureThumbnail())
curl -s -H "Authorization: Bearer axq_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"leadtime":"standard",
       "selections":[{"partId":"9f2c…","material":"al-6061","qty":10}]}' \
  -o quote.pdf \
  https://quote.axton.tools/api/v1/quotes/AXQ-260827-4F2A/pdf

Laravel controller and Next.js/PartViewer wiring for exactly this flow live in the repo's integration/ folder.