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.6 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Pindai gambar untuk kode QR, barcode, dan kode 2D dengan keluaran beranotasi.	97c9d395c257	human	2bab3a516dd4

Pembaca Barcode

Pindai gambar yang diunggah untuk semua jenis barcode dan kode QR. Mengembalikan teks yang didekode, jenis barcode, dan data posisi untuk setiap kode yang terdeteksi. Juga menghasilkan gambar beranotasi dengan kotak pembatas berwarna di sekitar kode yang terdeteksi.

API Endpoint

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

Menerima data formulir multipart dengan berkas gambar dan bidang JSON settings opsional.

Parameter

Parameter	Tipe	Wajib	Bawaan	Deskripsi
tryHarder	boolean	Tidak	`true`	Aktifkan mode pemindaian agresif untuk barcode yang lebih sulit dibaca (lebih lambat tetapi lebih menyeluruh)

Contoh Permintaan

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}'

Contoh Respons

{
  "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"
}

Bidang Respons

Bidang	Tipe	Deskripsi
filename	string	Nama berkas asli
barcodes	array	Larik objek barcode yang terdeteksi
annotatedUrl	string atau null	URL untuk mengunduh gambar beranotasi (null jika tidak ada barcode ditemukan)
previewUrl	string atau null	Sama seperti annotatedUrl (untuk kompatibilitas pratinjau frontend)

Objek Barcode

Bidang	Tipe	Deskripsi
type	string	Format barcode (QRCode, EAN-13, Code128, DataMatrix, PDF417, dll.)
text	string	Konten barcode yang didekode
position	object	Kotak pembatas dengan koordinat topLeft, topRight, bottomLeft, bottomRight

Jenis Barcode yang Didukung

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

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

Catatan

Menggunakan pustaka zxing-wasm untuk deteksi barcode.
Gambar beranotasi menampilkan kotak pembatas poligon berwarna dan label bernomor pada setiap barcode yang terdeteksi.
Hingga 255 barcode dapat dideteksi dalam satu gambar.
Jika tidak ada barcode ditemukan, barcodes adalah larik kosong dan annotatedUrl adalah null.
Mode tryHarder melakukan pemindaian yang lebih menyeluruh dengan mengorbankan waktu pemrosesan. Nonaktifkan untuk pemrosesan yang lebih cepat pada barcode yang bersih dan sejajar dengan baik.
Keluaran beranotasi selalu berformat PNG.
Input HEIC, RAW, PSD, dan SVG didekode secara otomatis sebelum pemindaian.
Orientasi EXIF diterapkan secara otomatis sebelum pemrosesan.

3.6 KiB Raw Blame History