Barkod Okuyucu

Yüklenen görselleri her türden barkod ve QR kodu için tarayın. Algılanan her kod için çözülmüş metni, barkod türünü ve konum verilerini döndürür. Ayrıca algılanan kodların çevresinde renkli sınırlayıcı kutular bulunan açıklamalı bir görsel oluşturur.

API Uç Noktası

POST /api/v1/tools/image/barcode-read

Bir görsel dosyası ve isteğe bağlı bir JSON settings alanı içeren multipart form verisi kabul eder.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
tryHarder	boole	Hayır	true	Okunması zor barkodlar için agresif tarama modunu etkinleştirir (daha yavaş ama daha kapsamlı)

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/barcode-read \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"tryHarder": true}'

Örnek Yanıt

{
  "filename": "receipt.jpg",
  "barcodes": [
    {
      "type": "QRCode",
      "text": "https://example.com/product/123",
      "position": {
        "topLeft": { "x": 100, "y": 50 },
        "topRight": { "x": 250, "y": 50 },
        "bottomLeft": { "x": 100, "y": 200 },
        "bottomRight": { "x": 250, "y": 200 }
      }
    },
    {
      "type": "EAN-13",
      "text": "5901234123457",
      "position": {
        "topLeft": { "x": 50, "y": 400 },
        "topRight": { "x": 300, "y": 400 },
        "bottomLeft": { "x": 50, "y": 450 },
        "bottomRight": { "x": 300, "y": 450 }
      }
    }
  ],
  "annotatedUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/annotated-receipt.png",
  "previewUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/annotated-receipt.png"
}

Yanıt Alanları

Alan	Tür	Açıklama
filename	dize	Özgün dosya adı
barcodes	dizi	Algılanan barkod nesnelerinin dizisi
annotatedUrl	dize veya null	Açıklamalı görseli indirme URL'si (barkod bulunmazsa null)
previewUrl	dize veya null	annotatedUrl ile aynı (ön uç önizleme uyumluluğu için)

Barkod Nesnesi

Alan	Tür	Açıklama
type	dize	Barkod biçimi (QRCode, EAN-13, Code128, DataMatrix, PDF417 vb.)
text	dize	Barkodun çözülmüş içeriği
position	nesne	topLeft, topRight, bottomLeft, bottomRight koordinatlı sınırlayıcı kutu

Desteklenen Barkod Türleri

1D barkodlar: Code128, Code39, Code93, Codabar, EAN-8, EAN-13, ITF, UPC-A, UPC-E

2D barkodlar: QRCode, DataMatrix, PDF417, Aztec, MaxiCode

Notlar

• Barkod algılama için zxing-wasm kitaplığını kullanır.
• Açıklamalı görsel, algılanan her barkodun üzerine renkli çokgen sınırlayıcı kutular ve numaralandırılmış etiketler yerleştirir.
• Tek bir görselde en fazla 255 barkod algılanabilir.
• Barkod bulunmazsa, barcodes boş bir dizidir ve annotatedUrl null'dur.
• tryHarder modu, işlem süresi pahasına daha kapsamlı tarama yapar. Temiz, düzgün hizalanmış barkodların daha hızlı işlenmesi için devre dışı bırakın.
• Açıklamalı çıktı her zaman PNG biçimindedir.
• HEIC, RAW, PSD ve SVG girişleri taranmadan önce otomatik olarak çözülür.
• İşlemeden önce EXIF yönlendirmesi otomatik olarak uygulanır.