Preskoči na glavni sadržaj
← CutOptim Engine APIEngine API · nesting · radi već danas

API za nesting krojnih markera

Da — postoji API za izradu krojnih markera. Slaganje dijelova kroja na rolu tkanine, kože ili tehničkog tekstila tako da marker bude što kraći je zadatak nestinga po stvarnom obliku s jednom otvorenom dimenzijom, a CutOptim Engine API ga rješava preko HTTP-a na POST /v1/optimize/nest. Vaš PLM, ERP ili softver za izradu po narudžbi šalje konture dijelova i širinu role u JSON-u i dobiva jedan marker: položaj svakog dijela i potrebnu duljinu — za odjeću, tapeciranje, kožnu galanteriju i tehničke tekstile.

Ovo radi već danas kao marker način nesting endpointa: redak materijala s roll: true i bez h. Isti engine stvarnih oblika koji slaže ploče slaže i dijelove kroja; mijenja se samo materijal, od ploče fiksne veličine do role fiksne širine i slobodne duljine.

Svi formati, motori, ograničenja i primjeri koda za programere: CutOptim API za nesting

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 nije dio javnog demoa — pokrenite ovaj primjer s besplatnim testnim ključem. Izradite besplatni testni ključ

  • Radi danas na POST /v1/optimize/nest — marker način, s retkom materijala roll (w i roll: true, bez h).
  • Vraća JEDNU ploču čiji je h najkraća pronađena duljina markera, uključujući razmak od ruba — i u metrics.length.
  • Dijelovi stvarnog oblika: poligoni (s rupama) ili SVG i DXF datoteke preko parts[].source.
  • Žica i dlaka: allowedRotations [0, 180] po dijelu zadržava smjer; options.minSeparation i options.edgeClearance postavljaju razmake.
  • stock[].maxLength ograničava marker (najviše 200000); dijelovi koji ne stanu idu u unplaced, nikada na drugu ploču.
  • lbf odgovara sinkrono za ponudu; max je asinkron (202, zatim prozivanje GET /v1/jobs/{id}) i može samo skratiti lbf marker.
  • Besplatna validacija: POST /v1/validate/nest provjerava posao bez ključa i bez kvote.

Rola nije ploča

Ploča ima dvije fiksne stranice, a pitanje je koliko ploča treba jedan posao. Rola ima jednu fiksnu stranicu — širinu — a pitanje je koliko duljine dijelovi potroše. Pošaljite redak materijala s w i roll: true, bez h, a nesting vraća JEDNU ploču širine w čiji je h najkraća pronađena duljina, uključujući razmak od ruba na oba kraja; ista vrijednost je u metrics.length. Duljina role je ono što kupujete, pa je to broj koji je potreban ponudi.

Što šaljete i što se vraća

Pošaljite svaki dio kroja kao poligon (s neobveznim rupama) ili kao SVG ili DXF preko parts[].source, s količinom. Odgovor daje svaki položaj kao krutu transformaciju (rotaciju u stupnjevima, zatim pomak x/y), duljinu markera i svaki dio koji nije stao, u unplaced. Svaki meta objekt — vaša referenca modela, veličine ili naloga za krojenje — vraća se nepromijenjen na svakoj postavljenoj kopiji, pa se marker usklađuje s vašim vlastitim sustavom.

Žica, dlaka i razmaci

allowedRotations se postavlja po dijelu: [0, 180] zadržava smjer žice ili dlake i ipak dopušta okretanje dijela za pola kruga, dok dulji popis ili "continuous" odgovara materijalu bez smjera. options.minSeparation postavlja razmak između dijelova, a options.edgeClearance razmak uz rubove role. Neobvezni stock[].maxLength ograničava marker na duljinu koju odaberete (najviše 200000 u vašoj jedinici): dijelovi koji ne stanu vraćaju se u unplaced, a rola nikada ne postaje druga ploča.

Odmah za ponudu, max za nalog za krojenje

Zadani engine lbf odgovara sinkrono — deterministički i unutar zahtjeva, dovoljno brzo da se marker može cijeniti dok klijent čeka. Za nalog za krojenje pošaljite isti body s engine: "max" i prozivajte GET /v1/jobs/{id}: kreće od lbf markera i vremenski proračun koji postavite (options.timeBudgetMs) troši na pretraživanje po pojasevima koje ga može skratiti, a nikada produljiti. Odgovor ima isti oblik u oba slučaja, a redak warnings navodi duljinu i, uz max, je li ju pretraga skratila.

Materijal za preuzimanje
One-pager API-ja za nesting krojnih markera

Sažetak na dvije stranice (PDF na engleskom) — problem, što šaljete i što dobivate natrag, zahtjev i odgovor te kako graditi na motoru. Spreman za ispis, s QR kodom koji vodi na ovu stranicu.

PDF2 straniceBesplatno
Preuzmi PDF

Česta pitanja

Postoji li API za izradu krojnih markera?
Da. Slaganje dijelova kroja na rolu tako da marker bude što kraći je marker način nesting endpointa CutOptim Engine API-ja, POST /v1/optimize/nest. Svaki dio šaljete kao poligon (ili SVG ili DXF) uz redak materijala sa širinom role i roll: true i dobivate jedan marker: položaj svakog dijela i njegovu duljinu. Radi u produkciji već danas, za odjeću, tapeciranje, kožu i tehničke tekstile.
Kako se određuje duljina markera?
Engine lbf postavlja dijelove i vraća duljinu koja im treba, sinkrono i deterministički. Uz engine: "max" posao se izvodi asinkrono: kreće od tog lbf markera, options.timeBudgetMs troši na traženje kraćeg pojasa i nikada ne vraća dulji. Duljina je h jedine vraćene ploče, uključujući razmak od ruba, a ponavlja se u metrics.length.
Mogu li zadržati smjer žice ili dlake?
Da. Postavite allowedRotations po dijelu: [0, 180] drži dio na smjeru žice i dopušta mu okretanje za pola kruga, a jedan kut potpuno ga učvršćuje. Dijelovi iz materijala bez smjera mogu dobiti dulji popis kutova ili "continuous". options.minSeparation i options.edgeClearance postavljaju razmak između dijelova i uz rubove role.
Mogu li ograničiti duljinu markera?
Da. stock[].maxLength ograničava marker na duljinu koju odaberete, najviše 200000 u vašoj jedinici. Dijelovi koji ne stanu vraćaju se u unplaced — rola nikada ne postaje druga ploča — pa vidite što je ostalo i odlučujete što s time.
Radi li gradaciju kroja, slaganje karo uzoraka ili planiranje prostiranja?
Ne. Slaže dijelove koje pošaljete: ne gradira kroj u veličine, ne slaže karo ili pruge i ne planira slojeve ni prostiranje. Pošaljite kao parts svaku veličinu i količinu koju želite u markeru, s meta objektom za vlastite reference, a odgovor kaže gdje ide svaka kopija.
Koliko materijala štedi?
Ovisi o dijelovima i širini role, zato ne navodimo opći postotak. Pošteno mjerilo je duljina markera za iste dijelove i istu širinu: pokrenite posao, usporedite duljinu sa svojim trenutnim markerom i usporedite lbf s max. max nikada ne vraća dulji marker od lbf-a. POST /v1/validate/nest provjerava posao besplatno, bez ključa i bez kvote.

Slučaj uporabe tekstil i tapeciranje (aplikacija) · Mjerila