Ale dirèkteman nan kontni an

Anviwònman tès ak kle tès

Ou ka konstwi epi teste entegrasyon ou san enprimant e san ajan enstale.

Anviwònman tès cloud la (kle jp_test_)​

Kreye yon kle API nan mòd tès (Tablo de bò → Devlopè → Kle API, mòd Test). Li kòmanse ak jp_test_.

Travay ki kreye ak yon kle tès pa janm rive sou yon aparèy. Cloud la enprime yo sou pwòp enprimant vityèl li:

  • ou pa bezwen aparèy ni enprimant (printerId ak deviceId pa obligatwa);
  • travay la pase nan queued, sending epi printed (oswa failed), epi li voye menm webhook ak yon vre travay;
  • travay resi, ESC/POS, raw ak tèks kenbe yon imaj PNG papye ki enprime a.
curl -X POST https://api.jodaprint.dev/v1/jobs \
-H "Authorization: Bearer jp_test_…" \
-H "Content-Type: application/json" \
-d '{"type":"text","encoding":"utf8","data":"Mèsi anpil"}'

curl https://api.jodaprint.dev/v1/jobs/<id>/preview \
-H "Authorization: Bearer jp_test_…" -o job.png

Ak SDK Node la: await jp.jobs.preview(job.id).

Se menm motè ajan an, konpile an WebAssembly, ki desinen imaj la, kidonk li montre egzakteman sa yon enprimant tèmik 80 mm oswa 58 mm enprime. Imaj ki sou entènèt (https://… nan yon blòk imaj) parèt tankou yon bwat ki bare, paske cloud la pa telechaje yo; imaj base64 ki anndan dokiman an parèt nòmal.

Travay tès yo pa konte nan travay chak mwa plan an. Yo gen "mode": "test" nan API a epi yo parèt nan lis travay tablo de bò a tankou lòt yo.

Apèsi resi​

POST /v1/receipt/preview transfòme nenpòt dokiman resi an PNG san kreye yon travay (otorizasyon jobs:write):

curl -X POST https://api.jodaprint.dev/v1/receipt/preview \
-H "Authorization: Bearer $JODAPRINT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"document":{"width":"58mm","blocks":[{"type":"text","value":"Tès"}]},"paper":"58mm"}' -o receipt.png

Opsyon: paper (58mm oswa 80mm), profile (pwofil enprimant, generic-80mm pa defo) ak footer (ajoute liy « Printed with JodaPrint » plan gratis la).

Enprimant vityèl lokal​

Chak ajan montre yon enprimant ki rele JodaPrint Virtual. Li anrejistre chak travay nan dosye done ajan an (virtual/): done yo voye bay enprimant lan, yon imaj PNG ak yon fichye JSON ki dekri travay la. Sèvi ak li pou teste mòd lokal depi navigatè a, san papye:

await jp.print({ printer: { name: "JodaPrint Virtual" }, type: "receipt", data: resiMwen });

Dezaktive l ak printers.virtual.enabled: false nan konfigirasyon aparèy la.