Describe native or exact shapes
Send Box or Cylinder dimensions, or an exact asset ID, revision, and measured envelope for a generated or prepared complex shape. The public service accepts up to 12 mold types and 60 total copies.
Developers ยท HTTPS JSON
Put the mold-fit check inside your software.
Send Box, Cylinder, or an exact prepared mold shape with a preset machine or explicit arm geometry. Receive placed counts, clearance, utilization, riser choice, and placement coordinates.
Request and result
Explicit physical units, checkable output
Choose or define the arm
Use a representative public-sample machine preset or send explicit straight or Offset/L arm, spider, envelope, and riser geometry.
Receive the placement
Read completeness, requested and placed counts, clearance, utilization, riser selection, stable arm geometry, and request-relative coordinates.
Millimetres or inches
Keep every length tied to its unit
Use explicit _mm fields on a 0.001 mm grid or matching decimal _in aliases. Do not send both aliases for the same value. Canonical physical result fields remain in millimetres.
Set display_unit to in when the client also needs the optional inch display projection.
Runnable examples
Start from a known request
The developer-preview package includes equivalent millimetre and inch requests plus Python, JavaScript, curl, and PowerShell clients.
Exact mold shapes
Build once, solve by exact identity
POST /api/geometry/generate publishes a canonical generated L shape, triangle, slope/wedge, tapered cylinder, or drawn footprint. POST /api/geometry/import accepts a prepared .rotogeom or .rotoshape file.
The response supplies the exact asset ID, revision, measured envelope, and allowed headings. Send that pair on the mold with response_api set to rotospider.layout-check.v3. Missing or mismatched shape data is rejected; it is never treated as a Box or Cylinder.
Prepared inputs only
Raw STEP stays on Windows
The public service does not accept raw STEP. Use RotoSpider Desktop for Windows to prepare STEP geometry, then consume its portable shape package from the Web App or API.
Developer preview
Evaluate first, then agree the production boundary
Current public service
The public endpoint is rate- and concurrency-limited and has no production service-level agreement. The schemas and examples remain under active iteration.
Factory integration
Bring machine, arm, and spider geometry; mold master data; process rules; and MOM or ERP mappings. Confirm versioning, capacity, access, and data handling before production use.
Do not send confidential factory orders or master data to the public service until data handling and access have been agreed for your integration.
Connecting MOM, ERP, or a planning workflow?
Discuss the current contract and your factory inputs before production integration.