mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
98 lines
3.6 KiB
Markdown
98 lines
3.6 KiB
Markdown
---
|
|
description: "Pindai gambar untuk kode QR, barcode, dan kode 2D dengan keluaran beranotasi."
|
|
i18n_source_hash: 97c9d395c257
|
|
i18n_provenance: human
|
|
i18n_output_hash: 2bab3a516dd4
|
|
---
|
|
|
|
# Pembaca Barcode {#barcode-reader}
|
|
|
|
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 {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/barcode-read`
|
|
|
|
Menerima data formulir multipart dengan berkas gambar dan bidang JSON `settings` opsional.
|
|
|
|
## Parameter {#parameters}
|
|
|
|
| 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 {#example-request}
|
|
|
|
```bash
|
|
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 {#example-response}
|
|
|
|
```json
|
|
{
|
|
"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 {#response-fields}
|
|
|
|
| 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 {#barcode-object}
|
|
|
|
| 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 {#supported-barcode-types}
|
|
|
|
Barcode 1D: Code128, Code39, Code93, Codabar, EAN-8, EAN-13, ITF, UPC-A, UPC-E
|
|
|
|
Barcode 2D: QRCode, DataMatrix, PDF417, Aztec, MaxiCode
|
|
|
|
## Catatan {#notes}
|
|
|
|
- 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.
|