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.7 KiB
Markdown
98 lines
3.7 KiB
Markdown
---
|
||
description: "Görselleri QR kodları, barkodlar ve 2D kodlar için tarayın ve açıklamalı çıktı alın."
|
||
i18n_source_hash: 97c9d395c257
|
||
i18n_provenance: human
|
||
i18n_output_hash: 711284980e48
|
||
---
|
||
|
||
# Barkod Okuyucu {#barcode-reader}
|
||
|
||
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ı {#api-endpoint}
|
||
|
||
`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 {#parameters}
|
||
|
||
| 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 {#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}'
|
||
```
|
||
|
||
## Örnek Yanıt {#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"
|
||
}
|
||
```
|
||
|
||
## Yanıt Alanları {#response-fields}
|
||
|
||
| 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 {#barcode-object}
|
||
|
||
| 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 {#supported-barcode-types}
|
||
|
||
1D barkodlar: Code128, Code39, Code93, Codabar, EAN-8, EAN-13, ITF, UPC-A, UPC-E
|
||
|
||
2D barkodlar: QRCode, DataMatrix, PDF417, Aztec, MaxiCode
|
||
|
||
## Notlar {#notes}
|
||
|
||
- 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.
|