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

5.0 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Сканування зображень на наявність QR-кодів, штрихкодів та двовимірних кодів з анотованим виводом.	97c9d395c257	human	b74b7d7c8b5a

Зчитувач штрихкодів

Сканування завантажених зображень на наявність усіх типів штрихкодів та QR-кодів. Повертає розшифрований текст, тип штрихкоду та дані про положення для кожного виявленого коду. Також генерує анотоване зображення з кольоровими обмежувальними рамками навколо виявлених кодів.

Кінцева точка API

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

Приймає дані форми у форматі multipart із файлом зображення та необов'язковим полем JSON settings.

Параметри

Параметр	Тип	Обов'язковий	Типове значення	Опис
tryHarder	boolean	Ні	`true`	Увімкнути агресивний режим сканування для складніших для зчитування штрихкодів (повільніше, але ретельніше)

Приклад запиту

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

Приклад відповіді

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

Поля відповіді

Поле	Тип	Опис
filename	string	Початкове ім'я файлу
barcodes	array	Масив об'єктів виявлених штрихкодів
annotatedUrl	string або null	URL для завантаження анотованого зображення (null, якщо штрихкодів не знайдено)
previewUrl	string або null	Те саме, що annotatedUrl (для сумісності з попереднім переглядом фронтенду)

Об'єкт штрихкоду

Поле	Тип	Опис
type	string	Формат штрихкоду (QRCode, EAN-13, Code128, DataMatrix, PDF417 тощо)
text	string	Розшифрований вміст штрихкоду
position	object	Обмежувальна рамка з координатами topLeft, topRight, bottomLeft, bottomRight

Підтримувані типи штрихкодів

Одновимірні штрихкоди: Code128, Code39, Code93, Codabar, EAN-8, EAN-13, ITF, UPC-A, UPC-E

Двовимірні штрихкоди: QRCode, DataMatrix, PDF417, Aztec, MaxiCode

Примітки

Використовує бібліотеку zxing-wasm для виявлення штрихкодів.
Анотоване зображення накладає кольорові багатокутні обмежувальні рамки та пронумеровані підписи на кожен виявлений штрихкод.
В одному зображенні можна виявити до 255 штрихкодів.
Якщо штрихкодів не знайдено, barcodes є порожнім масивом, а annotatedUrl дорівнює null.
Режим tryHarder виконує ретельніше сканування ціною часу обробки. Вимкніть його для швидшої обробки чистих, добре вирівняних штрихкодів.
Анотований вивід завжди у форматі PNG.
Вхідні дані HEIC, RAW, PSD та SVG автоматично декодуються перед скануванням.
Орієнтація EXIF застосовується автоматично перед обробкою.

5.0 KiB Raw Blame History