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
Web sayfalarını veya HTML parçacıklarını cihaz emülasyonuyla yüksek kaliteli görseller olarak yakalayın.	1e49d070ea2e	human	2cb79b9eabb8

HTML'den Görsele

Bir web sayfası URL'sini veya ham HTML içeriğini bir ekran görüntüsü görseli olarak yakalayın. Cihaz emülasyonunu (masaüstü, tablet, mobil), tam sayfa yakalamayı ve birden fazla çıktı biçimini destekler.

API Uç Noktası

POST /api/v1/tools/image/html-to-image

Bir JSON gövdesi kabul eder (multipart değil). Dosya yüklemesi gerekmez.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
url	string	Koşullu	-	Yakalanacak URL (geçerli bir URL olmalıdır)
html	string	Koşullu	-	İşlenecek ham HTML içeriği (1 ile 5.000.000 karakter arası)
format	string	Hayır	`"png"`	Çıktı biçimi: `jpg`, `png`, `webp`
quality	number	Hayır	`90`	Kayıplı biçimler için çıktı kalitesi (1 ile 100 arası)
fullPage	boolean	Hayır	`false`	Yalnızca görünüm alanını değil, kaydırılabilir tüm sayfayı yakala
devicePreset	string	Hayır	`"desktop"`	Cihaz emülasyonu: `desktop`, `tablet`, `mobile`, `custom`
viewportWidth	number	Hayır	`1280`	Piksel cinsinden özel görünüm alanı genişliği (320 ile 3840 arası, devicePreset `custom` olduğunda kullanılır)
viewportHeight	number	Hayır	`720`	Piksel cinsinden özel görünüm alanı yüksekliği (320 ile 2160 arası, devicePreset `custom` olduğunda kullanılır)

url veya html değerinden biri sağlanmalıdır, ancak ikisi birden değil.

Cihaz Ön Ayarları

Ön Ayar	Genişlik	Yükseklik	Mobil UA
`desktop`	1280	720	Hayır
`tablet`	768	1024	Hayır
`mobile`	375	812	Evet
`custom`	(kullanıcı tarafından belirtilir)	(kullanıcı tarafından belirtilir)	Hayır

Örnek İstek

Bir web sayfası yakalama:

curl -X POST http://localhost:1349/api/v1/tools/image/html-to-image \
  -H "Authorization: Bearer si_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": "png", "fullPage": true, "devicePreset": "desktop"}'

HTML içeriği işleme:

curl -X POST http://localhost:1349/api/v1/tools/image/html-to-image \
  -H "Authorization: Bearer si_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"html": "<div style=\"padding: 20px; background: #f0f0f0;\"><h1>Hello</h1></div>", "format": "png"}'

Örnek Yanıt

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

Notlar

Sunucuda Chromium'un kurulu olmasını gerektirir. Tarayıcı hizmeti mevcut değilse HTTP 503 döndürür.
URL'ler SSRF saldırılarına karşı doğrulanır (özel/dahili ağ adresleri engellenir).
Bu uç nokta saatte 120 istekle sınırlıdır.
Bu araç URL'lerden/HTML'den görsel ürettiği için originalSize her zaman 0'dır.
Çıktı dosya adı screenshot.<format> şeklindedir.
Sayfanın yüklenmesi çok uzun sürerse istek HTTP 504 (ağ geçidi zaman aşımı) döndürür.
Tarayıcı hizmeti tekrar tekrar çökerse geçici olarak devre dışı bırakılır ve BROWSER_CRASHED koduyla HTTP 503 döndürür.

3.6 KiB Raw Blame History Unescape Escape