API-referencia
Alap-URL https://api.cutoptim.com · szerződésverzió v1
Készíts kulcsot az irányítópultodon, majd így küldd el: Authorization: Bearer <key>.
▶ Próbáld ki élőben — regisztráció nélkülNyilvános demókulccsal fut — korlátozott, csak kis munkák, sosem számlázzuk.
Integrációk
ÚtmutatókEN
FogalmakEN
Végpontok
| Metódus | Útvonal | Leírás |
|---|---|---|
| POST | /v1/optimize/2d | 2D lapoptimalizálás |
| POST | /v1/optimize/1d | 1D / lineáris optimalizálás (rúd, profil, cső) |
| POST | /v1/optimize/wood | faanyag-optimalizálás — 1D keresztmetszet-párosítással |
| POST | /v1/optimize/nest | valódi alakú nesting — szabálytalan poligonok fix táblákon, kizárási zónákkal (lézer / plazma / vízsugár) |
| POST | /v1/validate/2d | kérés ellenőrzése megoldás nélkül — ingyenes, nincs kulcs, nincs kvóta (2d / 1d / wood / nest) |
| POST | /v1/validate/1d | kérés ellenőrzése megoldás nélkül — ingyenes, nincs kulcs, nincs kvóta (2d / 1d / wood / nest) |
| POST | /v1/validate/wood | kérés ellenőrzése megoldás nélkül — ingyenes, nincs kulcs, nincs kvóta (2d / 1d / wood / nest) |
| POST | /v1/validate/nest | kérés ellenőrzése megoldás nélkül — ingyenes, nincs kulcs, nincs kvóta (2d / 1d / wood / nest) |
| GET | /v1/jobs/{id} | egy aszinkron max motoros feladat lekérdezése — visszaadja a státuszát, és ha kész, a tervet (nincs kvóta; csak a saját feladataid) |
| POST | /v1/import/nest | darab-kontúrok kiolvasása SVG- vagy DXF-fájlból — kulcs kell hozzá, kvótát nem fogyaszt |
| GET | /v1/usage | a FIÓK aktuális hónapra eső felhasználása és kvótája |
| GET | /v1/health | életjel — nincs kulcs, nincs kéréslimit, nincs adatbázis |
POST /v1/validate/{2d,1d,wood,nest} — response
The request is well-formed. No solve ran and no quota was spent.
| Mező | Típus | Leírás |
|---|---|---|
| valid | boolean | Always true on a 200 — a malformed request is a 400 with the exact bad field path (details.path) instead. The body is the SAME one the matching optimize endpoint takes. |
| mode | "2d" | "1d" | "wood" | "nest" | The endpoint you called. |
| contractVersion | string | Shape version. Currently "1". |
| engineEnabled | boolean | Nest only — whether the nesting engine is built into this deployment. Absent for the rectangular modes. |
| parts | { rows, total } | Part rows sent, and the total quantity after qty expansion. Check it against the part cap before you spend a call. |
| parts.rows | integer | Number of part rows sent. |
| parts.total | integer | Total quantity across all part rows (Σ qty). |
| stock | { rows, total } | The same for stock. |
| stock.rows | integer | Number of stock rows sent. |
| stock.total | integer | Total quantity across all stock rows (Σ qty). |
| warnings | string[] | Approximate, solve-free feasibility notes — e.g. a part that fits no stock (2D and nest: by bounding box; wood: no matching section long enough). Empty ⇒ every part fits some stock. Ignores trim/kerf/material (a shape check, not a solve). |
OpenAPI-specifikáció
Egy gépi olvasásra szánt OpenAPI 3.1 dokumentum leírja mind a tizenkét végpontot, minden kéréstörzset, minden válaszszerkezetet és minden hibát. Erre állítsd rá a kliens-generátorodat, ahelyett hogy ezt a lapot írnád át kézzel. Maga a dokumentum csak angol nyelvű: szerződés-tokenekből áll, és az OpenAPI-nak nincs lokalizációs mechanizmusa.
curl -s https://cutoptim.com/engine/openapi.json > cutoptim-engine.jsonOpenAPI 3.1 dokumentum megnyitása →
- TypeScript
npm install @cutoptim/engine
GitHub · npm - Python
pip install cutoptim
GitHub · PyPI - PHP
composer require cutoptim/engine
GitHub · Packagist
A two-page summary of the Engine API — the four modes (2D, 1D, wood and true-shape nest), a request and response, determinism and pricing. Print-ready, with a QR back to the docs.