Uporaba API-ja HTTP: BeamBench

Upravljajte Beam Bench s katerim koli odjemalcem HTTP. Enake operacije kot CLI, prijazno do integracij.

HTTP / WebSocket API aplikacije Beam Bench je isti vmesnik, s katerim komunicira CLI. Če želite Beam Bench uporabljati v okolju, ki ne uporablja CLI, na primer v spletni aplikaciji, integracijskem strežniku ali mobilni aplikaciji, uporabite API HTTP neposredno.

Kaj potrebujete

Nameščen Beam Bench.
Lokalni API, omogočen v Edit → Settings → General. Privzeto je izklopljen.
Odjemalca HTTP (curl, knjižnico HTTP v vašem jeziku, Postman itd.).

Preverite, ali je API omogočen

Privzete nastavitve v trenutni različici so namenoma omejene:

Local API: izklopljeno.
Vrata API: 5900.
Allow network devices to connect: izklopljeno. Dokler je izklopljeno, strežnik sprejema povezave samo iz tega računalnika.

Odprite namizno aplikacijo, pojdite v Edit → Settings → General in vklopite Local API. Za skripte, ki se izvajajo v istem računalniku, naj bo Allow network devices to connect izklopljeno. Nastavitve začnejo veljati takoj.

Pred vezavo na omrežje v skupnem omrežju Wi-Fi preberite stran API-ja HTTP. API nima preverjanja pristnosti ter lahko premika stroj in sproži laser.

Osnovni URL

http://localhost:5900/api/v1

(Ali uporabite naslov IP LAN svojega računalnika namesto localhost, ko je možnost Allow network devices to connect vklopljena.)

Koraki

1. Preverite, ali API deluje

curl -s http://localhost:5900/api/v1/agent/capabilities | jq .

Vrne shemo zmožnosti. (Če ste spremenili vrata, zamenjajte 5900 z nastavljenimi vrati.)

2. Preverite stanje

curl -s http://localhost:5900/api/v1/agent/state | jq .

3. Odprite projekt

curl -s -X POST http://localhost:5900/api/v1/projects/open \
  -H 'Content-Type: application/json' \
  -d '{"path":"/abs/path/to/file.lzrproj"}'

4. Izrišite zasnovo (brez grafičnega vmesnika)

curl -s -X POST http://localhost:5900/api/v1/design/render \
  -H 'Content-Type: application/json' \
  -d '{"format":"png","pixels_per_mm":4,"output_path":"/tmp/out.png"}'

5. Pridobite stanje kamere

curl -s http://localhost:5900/api/v1/camera/state | jq .

6. Izrišite prekrivanje kamere (zahteva aplikacijo)

curl -s -X POST http://localhost:5900/api/v1/camera/overlay/render \
  -H 'Content-Type: application/json' \
  -d '{"output_path":"/tmp/overlay.png","view":"fit","keep":true}'

Razpoložljive skupine končnih točk

Za celoten vmesnik glejte razdelek referenca API-ja (ko bo izpolnjen). Glavne skupine:

/agent, zmožnosti, stanje, vodnik.
/camera, naprave, stanje, zajem, prekrivanje (prikaz, pretvorba, izris), umerjanje, poravnava.
/design, opis, izris, transakcije.
/projects, odpiranje, shranjevanje, zapiranje, plasti, predmeti, razveljavitev/ponovitev, uvoz.
/export, svg, dxf, pdf, eps, ai.

Varnost

Strežnik API nima preverjanja pristnosti. Predpostavlja, da je omrežje, v katerem deluje, zaupanja vredno.

Vezava samo na localhost omeji izpostavljenost na lokalni računalnik.
Vezava na omrežje je ločena možnost, ki jo morate izrecno vklopiti, in odpre API vsem v istem omrežju LAN. Omogočite jo samo v zaupanja vrednem omrežju.

Preverite, ali je delovalo

curl agent/capabilities vrne JSON.
Klic za izris ustvari zahtevano datoteko.

Uporaba API-ja HTTP