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

4.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
التقاط صفحات الويب أو مقتطفات HTML كصور عالية الجودة مع محاكاة الأجهزة.	1e49d070ea2e	human	3cddba8ad0f1

HTML إلى صورة

التقط عنوان URL لصفحة ويب أو محتوى HTML خام كصورة لقطة شاشة. يدعم محاكاة الأجهزة (سطح المكتب، الجهاز اللوحي، الهاتف المحمول)، والتقاط الصفحة الكاملة، وصيغ مخرجات متعددة.

نقطة نهاية API

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

يقبل جسم JSON (وليس multipart). لا حاجة لرفع ملف.

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
url	string	مشروط	-	عنوان URL للالتقاط (يجب أن يكون عنوان URL صالحاً)
html	string	مشروط	-	محتوى HTML خام للتصيير (1 إلى 5,000,000 حرف)
format	string	لا	`"png"`	صيغة المخرجات: `jpg`، `png`، `webp`
quality	number	لا	`90`	جودة المخرجات للصيغ ذات الفقدان (1 إلى 100)
fullPage	boolean	لا	`false`	التقاط الصفحة القابلة للتمرير بالكامل، وليس منفذ العرض فقط
devicePreset	string	لا	`"desktop"`	محاكاة الجهاز: `desktop`، `tablet`، `mobile`، `custom`
viewportWidth	number	لا	`1280`	عرض منفذ العرض المخصص بالبكسل (320 إلى 3840، يُستخدم عندما يكون devicePreset هو `custom`)
viewportHeight	number	لا	`720`	ارتفاع منفذ العرض المخصص بالبكسل (320 إلى 2160، يُستخدم عندما يكون devicePreset هو `custom`)

يجب توفير url أو html، لكن ليس كليهما.

إعدادات الأجهزة المسبقة

الإعداد المسبق	العرض	الارتفاع	UA الجوال
`desktop`	1280	720	لا
`tablet`	768	1024	لا
`mobile`	375	812	نعم
`custom`	(يحدده المستخدم)	(يحدده المستخدم)	لا

مثال على طلب

التقاط صفحة ويب:

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:

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

مثال على استجابة

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

ملاحظات

يتطلب تثبيت Chromium على الخادم. يُرجع HTTP 503 إذا لم تكن خدمة المتصفح متاحة.
يتم التحقق من عناوين URL ضد هجمات SSRF (يتم حظر عناوين الشبكة الخاصة/الداخلية).
نقطة النهاية هذه محدودة المعدل إلى 120 طلباً في الساعة.
originalSize يكون دائماً 0 لأن هذه الأداة تولّد صوراً من عناوين URL/HTML.
اسم ملف المخرجات هو screenshot.<format>.
إذا استغرقت الصفحة وقتاً طويلاً في التحميل، يُرجع الطلب HTTP 504 (مهلة البوابة).
إذا تعطلت خدمة المتصفح مراراً، يتم تعطيلها مؤقتاً وتُرجع HTTP 503 مع الرمز BROWSER_CRASHED.

4.1 KiB Raw Blame History