# ENCY Nest

> Online nesting of flat parts (DXF or SVG) on sheets and cutting programs for laser, plasma, waterjet and router.
> Free nesting; exporting programs needs a Pro plan.

API: https://nest.encycam.com — OpenAPI 3.1 at /api/openapi.json.

## Authentication
Create a key in Account → API and send `Authorization: Bearer nk_…`. The key opens every `/api/…` endpoint of the web app.

## Nest in one request
POST /api/v1/nest?wait=60 — multipart/form-data:
- `files`: one or more DXF / SVG files (closed contours are parts; holes are found by nesting of contours).
- `settings` (optional): JSON merged over the defaults, e.g.
  {"sheets":[{"width":1250,"length":2500,"qty":null}],"margin":10,"gapAuto":true,"machine":"laser-iso","thickness":3,"rotation":"90","quantities":{"1":10,"2":4}}
Header `Idempotency-Key` makes a retry return the same job.
Reply: {"id","status","error","job","result"} — 200 when finished, 202 while it runs (poll GET /api/jobs/{id}).

## After the nesting
- GET /api/jobs/{id}/result — sheets with placements (x, y, angle a in radians, mirrored) and the toolpath.
- GET /api/jobs/{id}/verify — the program check (cut into parts, uncut contours, program vs toolpath).
- POST /api/jobs/{id}/estimate — material, machine time, price per part.
- GET /api/jobs/{id}/export/gcode?sheet=1 (or clt, dxf) — the program; Pro.

## Webhook
Set it in Account → API. On `job.finished` it gets {"event","id","name","status","sheets","utilization","error"}
with `X-Nest-Signature: t=<unix>,v1=<hex HMAC-SHA256(secret, "<t>.<body>")>`.

## Units and axes
Millimetres. Sheet X along the length, Y across the width, origin at the sheet corner.