API أدوات التوليد

نقاط وصول لتوليد رموز QR، أيقونات المواقع، لقطات الشاشة، والتقاط PDF من عناوين URL. بعض نقاط الوصول تقبل JSON بدلاً من multipart/form-data -- تحقق من نوع المحتوى لكل نقطة وصول.

توليد رمز QR

POST/api/qr-generate

ولّد صورة رمز QR من نص أو عنوان URL. أرسل محتوى JSON (Content-Type: application/json). خصّص الألوان والحجم ومستوى تصحيح الأخطاء.

Parameters

Name	Type	Required	Description
`text`	string	Required	المحتوى المراد ترميزه في رمز QR (نص، URL، إعدادات WiFi، إلخ.)
`size`	number	Optional	حجم رمز QR بالبكسل. الافتراضي: 300
`errorCorrection`	string	Optional	مستوى تصحيح الأخطاء: "L" (7%)، "M" (15%)، "Q" (25%)، "H" (30%). الافتراضي: "M"
`fgColor`	string	Optional	لون المقدمة بصيغة ست عشرية (مثال: "#000000"). الافتراضي: "#000000"
`bgColor`	string	Optional	لون الخلفية بصيغة ست عشرية (مثال: "#ffffff"). الافتراضي: "#ffffff"

Response:صورة PNG

bash

curl -X POST https://freefiletools.io/api/qr-generate \
  -H "x-api-key: fft_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "https://freefiletools.io",
    "size": 400,
    "errorCorrection": "H",
    "fgColor": "#f97316",
    "bgColor": "#ffffff"
  }' \
  -o qrcode.png

توليد أيقونة الموقع

POST/api/favicon-generate

ولّد حزمة أيقونات موقع كاملة من صورة مصدرية. يُرجع ملف ZIP يحتوي على أحجام أيقونات متعددة (16x16، 32x32، 48x48، إلخ.) وملف ICO.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف صورة مصدرية (يُوصى بـ PNG أو JPG أو SVG)

Response:ملف ZIP يحتوي على ملفات أيقونات الموقع

bash

curl -X POST https://freefiletools.io/api/favicon-generate \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o favicons.zip

HTML إلى صورة

POST/api/html-to-image

التقط لقطة شاشة لصفحة ويب. أرسل محتوى JSON (Content-Type: application/json). خصّص حجم منفذ العرض وتنسيق الإخراج.

Parameters

Name	Type	Required	Description
`url`	string	Required	عنوان URL للالتقاط (يجب أن يتضمن https://)
`format`	string	Optional	تنسيق الإخراج: "png" أو "jpg". الافتراضي: "png"
`width`	number	Optional	عرض منفذ العرض بالبكسل. الافتراضي: 1280
`height`	number	Optional	ارتفاع منفذ العرض بالبكسل. الافتراضي: 800

Response:صورة PNG أو JPG

bash

curl -X POST https://freefiletools.io/api/html-to-image \
  -H "x-api-key: fft_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "png",
    "width": 1440,
    "height": 900
  }' \
  -o screenshot.png

URL إلى PDF

POST/api/url-to-pdf

حوّل صفحة ويب إلى مستند PDF. أرسل محتوى JSON (Content-Type: application/json). يتم عرض الصفحة بالكامل قبل التحويل.

Parameters

Name	Type	Required	Description
`url`	string	Required	عنوان URL للتحويل (يجب أن يتضمن https://)

Response:ملف PDF

bash

curl -X POST https://freefiletools.io/api/url-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}' \
  -o page.pdf