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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Özel renkler ve hata düzeltme seviyeleriyle QR kodları oluşturun.	096ef4d90da5	human	6e888be32809

QR Kodu Oluşturucu

Yapılandırılabilir boyut, hata düzeltme seviyesi ve özel ön plan/arka plan renkleriyle metin veya URL'lerden QR kodu görselleri oluşturun.

API Uç Noktası

POST /api/v1/tools/image/qr-generate

Bir JSON gövdesi kabul eder (çok parçalı değil). Dosya yüklemeye gerek yoktur.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
text	string	Evet	-	QR koduna kodlanacak içerik (1 ile 2000 karakter arası)
size	number	Hayır	`400`	Piksel cinsinden çıktı görseli genişliği/yüksekliği (100 ile 10000 arası)
errorCorrection	string	Hayır	`"M"`	Hata düzeltme seviyesi: `L` (%7), `M` (%15), `Q` (%25), `H` (%30)
foreground	string	Hayır	`"#000000"`	Hex cinsinden QR kodu ön plan/modül rengi (`#RRGGBB`)
background	string	Hayır	`"#FFFFFF"`	Hex cinsinden QR kodu arka plan rengi (`#RRGGBB`)
logoDataUri	string	Hayır	-	Veri URI'si olarak logo görseli (`data:image/png;base64,...` veya `data:image/jpeg;base64,...`, en fazla 700 KB). QR kodunun ortasında QR boyutunun %22'sinde konumlandırılır. Hata düzeltmeyi `H` değerine zorlar

Hata Düzeltme Seviyeleri

Seviye	Kurtarma	Kullanım Durumu
`L`	~%7	Maksimum veri yoğunluğu
`M`	~%15	Dengeli (varsayılan)
`Q`	~%25	Basılı kodlar için iyi
`H`	~%30	Logo kaplamalı kodlar için en iyisi

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/qr-generate \
  -H "Authorization: Bearer si_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"text": "https://snapotter.com", "size": 500, "errorCorrection": "H"}'

Özel renklerle markalı QR kodu:

curl -X POST http://localhost:1349/api/v1/tools/image/qr-generate \
  -H "Authorization: Bearer si_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello World", "size": 300, "foreground": "#1a365d", "background": "#f7fafc"}'

Örnek Yanıt

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/qrcode.png",
  "originalSize": 0,
  "processedSize": 4520
}

Notlar

Bu uç nokta, görsel yüklemeye gerek olmadığından çok parçalı form verisi değil JSON kabul eder.
Çıktı her zaman bir PNG görselidir.
Çıktı dosya adı her zaman qrcode.png şeklindedir.
Bu araç görselleri sıfırdan oluşturduğundan originalSize her zaman 0'dır.
QR kodunun etrafında 2 modüllük bir sessiz bölge (kenar boşluğu) bulunur.
Maksimum metin uzunluğu 2000 karakterdir. Gerçek kapasite, hata düzeltme seviyesine ve karakter kodlamasına bağlıdır.
Daha yüksek hata düzeltme seviyeleri, QR kodunun kısmen gizlenmiş olsa bile taranabilir kalmasını sağlar ancak veri kapasitesini azaltır.
Bir logoDataUri sağlandığında, logonun ortayı kapatmasına rağmen QR kodunun taranabilir kalması için hata düzeltmesi otomatik olarak H (%30) değerine zorlanır.

3.4 KiB Raw Blame History Unescape Escape