---
title: "Baski Gonder"
method: POST
path: "/v1/print"
---

# Baski Gonder

`POST /v1/print`

## Request

- Base URL: `https://api.labelixa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.labelixa.com/v1/print`
- Auth: none declared

Baskı işini KUYRUĞA ALIR.

**Bu uç tek başına BASMAZ.** İş `queued` durumunda bekler; onu yazıcıya
ileten agent henüz yok (PRN-003). Yanıt bunu `basim_onaylandi: false`
ve `not` alanıyla AÇIKÇA söyler — "kabul edildi"yi "basıldı" sanan bir
entegrasyon, PRN-015'te uzak durmaya karar verdiğimiz yanlış vaadin ta
kendisidir.

Ücretlendirme `baski.ucretlendirilir_mi` kararına bırakılır: daha önce
render edilmiş bir işin referansı verilirse baskı bedava, ham ZPL
doğrudan gelirse etiket BURADA üretilmiş sayılır ve burada ücretlenir.
Yoksa render'ı atlayıp baskıdan geçen bir kaçış yolu açılırdı.

**`Idempotency-Key` desteklenir (PLT-016).** Bu uçta idempotency'nin
bedeli ötekilerden AĞIR: `/v1/labels`de tekrarlanan istek fazladan bir
kayıt, `/v1/bulk/jobs`ta fazladan kota demek; burada **fazladan
BASILMIŞ bir etiket** demek. Ağ zaman aşımı yaşayan bir istemcinin
yapacağı en makul şey isteği yeniden göndermektir ve o an kâğıt çoktan
çıkmış olabilir. PRN-022'nin kuyruk tarafında çözdüğü sorunun API
tarafındaki hâli budur.

Özellik OPT-IN: başlığı göndermeyen istemci bugünkü davranışı aynen
görür. Zorunlu kılmak sahadaki her entegrasyonu bir gecede kırardı.

## Request body

- BaskiIstegi: Baskı isteği. **`zpl` ile `yuk` aynı alanın iki adıdır** (PLT-013 geçiş dönemi). Taşınan şey opak bayttır ve ZPL bunun yalnız bir hâli; yeni ad `yuk`. Eski ad kaldırılmadı çünkü sahadaki entegrasyonlar (ve dokümandaki her örnek) `zpl` gönderiyor — bir alan adını tek sürümde kaldırmak, müşteri entegrasyonunu sessizce 422'ye düşürürdü. İkisi birden verilirse istek REDDEDİLİR: hangisinin kazandığını tahmin ettirmek, "gönderdiğim şey basılmadı" sınıfından en pahalı hatayı doğurur.
  - `device_id` string
  - `zpl` string
  - `yuk` string
  - `dil` string
  - `kopya` integer
  - `etiket_sayisi` integer
  - `kaynak_is_id` string
  - `sablon_id` string
  - `degiskenler` object
  - `printer_group` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/labelixa/apis/labelixa-api.md) · [All operations](https://skmtc.dev/labelixa/apis/labelixa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/labelixa/apis/labelixa-api/revisions/721af7a6f2cc?raw)