mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

3.7 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Görselleri QR kodları, barkodlar ve 2D kodlar için tarayın ve açıklamalı çıktı alın.	97c9d395c257	human	711284980e48

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 "file=@receipt.jpg" \
  -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.

3.7 KiB Raw Blame History Unescape Escape