Sari la conținutul principal
← CutOptim Engine APIEngine API · nesting · live astăzi

API nesting pentru markere de croit textil

Da — există un API pentru realizarea markerelor. Așezarea pieselor de tipar pe o rolă de țesătură, piele sau textil tehnic astfel încât markerul să fie cât mai scurt este o problemă de nesting pe forma reală cu o dimensiune liberă, iar CutOptim Engine API o rezolvă prin HTTP la POST /v1/optimize/nest. PLM-ul, ERP-ul sau software-ul dumneavoastră de producție la comandă trimite conturul pieselor și lățimea rolei în JSON și primește un marker: poziția fiecărei piese și lungimea necesară — pentru confecții, tapițerie, marochinărie și textile tehnice.

Este live astăzi ca modul marker al endpoint-ului de nesting: un rând de stoc cu roll: true și fără h. Același motor pe forma reală care așază plăcile așază și piesele; se schimbă doar stocul, de la o foaie de dimensiune fixă la o rolă de lățime fixă și lungime liberă.

Toate formatele, motoarele, limitele și exemplele de cod pentru dezvoltatori: API de nesting CutOptim

POST /v1/optimize/nest
{
  "parts": [
    { "name": "front",
      "polygon": [[0,0],[560,0],[560,700],[420,760],[140,760],[0,700]],
      "qty": 2, "allowedRotations": [0,180] },
    { "name": "sleeve",
      "polygon": [[0,0],[480,0],[420,560],[60,560]],
      "qty": 4, "allowedRotations": [0,180] },
    { "name": "collar",
      "polygon": [[0,0],[500,0],[500,80],[0,80]],
      "qty": 2, "allowedRotations": [0,180] }
  ],
  "stock": [{ "w": 1585, "roll": true }],
  "options": { "minSeparation": 3, "edgeClearance": 5 }
}

Nesting-ul nu face parte din demo-ul public — rulați acest exemplu cu o cheie de test gratuită. Creează o cheie de test gratuită

  • Live astăzi la POST /v1/optimize/nest — modul marker, cu un rând de stoc roll (w și roll: true, fără h).
  • Returnează O SINGURĂ foaie al cărei h este cea mai scurtă lungime de marker găsită, cu distanța de margine — și în metrics.length.
  • Piese pe forma reală: poligoane (cu găuri) sau fișiere SVG și DXF prin parts[].source.
  • Fir și sensul perului: allowedRotations [0, 180] pe piesă păstrează direcția; options.minSeparation și options.edgeClearance setează distanțele.
  • stock[].maxLength limitează markerul (cel mult 200000); piesele care nu încap merg în unplaced, niciodată pe a doua foaie.
  • lbf răspunde sincron pentru ofertă; max este asincron (202, apoi interogați GET /v1/jobs/{id}) și poate doar să scurteze markerul lbf.
  • Validare gratuită: POST /v1/validate/nest verifică o lucrare fără cheie și fără cotă.

O rolă nu este o foaie

O foaie are două laturi fixe, iar întrebarea este câte foi cere o lucrare. O rolă are o singură latură fixă — lățimea — iar întrebarea este câtă lungime consumă piesele. Trimiteți un rând de stoc cu w și roll: true, fără h, iar nesting-ul returnează O SINGURĂ foaie de lățime w al cărei h este cea mai scurtă lungime găsită, cu distanța de margine inclusă la ambele capete; aceeași valoare se găsește în metrics.length. Lungimea rolei este ceea ce cumpărați, deci este numărul de care are nevoie o ofertă.

Ce trimiteți și ce primiți

Trimiteți fiecare piesă de tipar ca poligon (cu găuri opționale) sau ca SVG ori DXF prin parts[].source, cu o cantitate. Răspunsul dă fiecare poziție ca transformare rigidă (o rotație în grade, apoi o translație x/y), lungimea markerului și orice piesă care nu a încăput, în unplaced. Orice obiect meta — referința dumneavoastră de model, mărime sau ordin de croit — se întoarce neschimbat pe fiecare copie plasată, astfel încât markerul se reconciliază cu propriul sistem.

Fir, sensul perului și distanțe

allowedRotations se setează pe piesă: [0, 180] păstrează direcția firului sau a perului și permite totuși întoarcerea piesei cap-coadă, în timp ce o listă mai lungă sau "continuous" se potrivește unui material fără direcție. options.minSeparation setează distanța dintre piese, iar options.edgeClearance distanța la marginile rolei. Un stock[].maxLength opțional limitează markerul la o lungime aleasă de dumneavoastră (cel mult 200000 în unitatea dumneavoastră): piesele care nu încap în ea se întorc în unplaced, iar o rolă nu devine niciodată a doua foaie.

Instant pentru ofertă, max pentru ordinul de croit

Motorul implicit lbf răspunde sincron — determinist și în cadrul cererii, suficient de rapid cât să calculați prețul unui marker cât așteaptă clientul. Pentru ordinul de croit, trimiteți același body cu engine: "max" și interogați GET /v1/jobs/{id}: pornește de la markerul lbf și folosește bugetul de timp setat de dumneavoastră (options.timeBudgetMs) pentru o căutare pe bandă care îl poate scurta și nu îl lungește niciodată. Răspunsul are aceeași formă în ambele cazuri, iar o linie warnings numește lungimea și, cu max, dacă căutarea a scurtat-o.

Resursă descărcabilă
One-pager API nesting pentru markere de croit textil

Un rezumat de două pagini (PDF în limba engleză) — problema, ce se trimite și ce se primește, o cerere și un răspuns, precum și cum se construiește pe motor. Gata de tipărit, cu un cod QR către această pagină.

PDF2 paginiGratuit
Descarcă PDF-ul

Întrebări frecvente

Există un API pentru realizarea markerelor?
Da. Așezarea pieselor de tipar pe o rolă astfel încât markerul să fie cât mai scurt este modul marker al endpoint-ului de nesting al CutOptim Engine API, POST /v1/optimize/nest. Trimiteți fiecare piesă ca poligon (sau SVG ori DXF) plus un rând de stoc cu lățimea rolei și roll: true și primiți un marker: poziția fiecărei piese și lungimea lui. Rulează în producție astăzi, pentru confecții, tapițerie, piele și textile tehnice.
Cum se stabilește lungimea markerului?
Motorul lbf așază piesele și returnează lungimea de care au nevoie, sincron și determinist. Cu engine: "max" lucrarea rulează asincron: pornește de la acel marker lbf, folosește options.timeBudgetMs pentru a căuta o bandă mai scurtă și nu returnează niciodată una mai lungă. Lungimea este h-ul singurei foi returnate, cu distanța de margine, și se repetă în metrics.length.
Pot păstra direcția firului sau a perului?
Da. Setați allowedRotations pe piesă: [0, 180] ține piesa pe direcția firului și o lasă să se întoarcă cap-coadă, iar un singur unghi o fixează complet. Piesele dintr-un material fără direcție pot primi o listă mai lungă de unghiuri sau "continuous". options.minSeparation și options.edgeClearance setează distanța dintre piese și la marginile rolei.
Pot limita lungimea markerului?
Da. stock[].maxLength limitează markerul la o lungime aleasă de dumneavoastră, cel mult 200000 în unitatea dumneavoastră. Piesele care nu încap în ea se întorc în unplaced — o rolă nu devine niciodată a doua foaie — așa că vedeți ce rămâne și decideți ce faceți cu ele.
Face gradare, potrivire de carouri sau planificarea așternerii?
Nu. Așază piesele pe care le trimiteți: nu gradează un tipar în mărimi, nu potrivește carouri sau dungi și nu planifică straturile sau așternerea. Trimiteți ca parts fiecare mărime și cantitate dorită în marker, cu un obiect meta pentru referințele dumneavoastră, iar răspunsul vă spune unde merge fiecare copie.
Câtă țesătură economisește?
Depinde de piese și de lățimea rolei, de aceea nu citez un procent general. Măsura cinstită este lungimea markerului pe aceleași piese și aceeași lățime: rulați lucrarea, comparați lungimea cu markerul dumneavoastră actual și comparați lbf cu max. max nu returnează niciodată un marker mai lung decât lbf. POST /v1/validate/nest verifică o lucrare gratuit, fără cheie și fără cotă.

Caz de utilizare textile și tapițerie (app) · Benchmarkuri