التقط لقطات شاشة لموقع الويب باستخدام واجهة برمجة تطبيقات RESTful Screenshot API

تتيح لك واجهة برمجة تطبيقات Rrab API الخاصة بـ GrabzIt التقاط عناوين URL أو HTML باستخدام تقنيات RESTful بالكامل. قبل البدء ، يرجى قراءة التحذيرات التالية بعناية اعتمادًا على حالة استخدامك ، ربما يكون أحد حلول API الأخرى لدينا أكثر ملاءمة.

- لا تتوفر بعض الميزات مثل الدمج والتشفير من خلال REST API. لاستخدام هذه الميزات ، ستحتاج إلى استخدام ميزة أخرى مكتبة API
- لا تستخدم واجهة برمجة التطبيقات هذه من جانب العميل ، لأنها ستكشف عن مفتاح التطبيق الخاص بك! بدلا من استخدام واجهة برمجة تطبيقات جافا سكريبت

للبدء ، ما عليك سوى تحديد ما تريد القيام به من الفلتر أدناه وسيتم عرض المعلمات المتاحة جنبًا إلى جنب مع مثال أساسي.

ماذا تريد أن تفعل؟

عند تقديم الطلبات يرجى التأكد من جميع قيم المعلمات هي ترميز URL.

    https://api.grabz.it/services/convert?key=Sign in to view your Application Key&format=&url=https%3A%2F%2Fspacex.com%2F

عند تحويل HTML يجب أن تكون جميع المعلمات نشر في نص الطلب كأزواج مفتاح القيمة. تأكد من أن جميع قيم المعلمات مشفرة بعنوان URL ، وأن نوع المحتوى هو application / x-www-form-urlencoded.

    curl 
    -d key=Sign in to view your Application Key 
    -d format= 
    -d html=%3Ch1%3EConvert%20Me%21%3C%2Fh1%3E 
    https://api.grabz.it/services/convert

سيتم بعد ذلك إرجاع الالتقاط في استجابة HTTP. تتوفر أيضًا الخيارات الإضافية التالية مع هذا النوع من الالتقاط ، وكلها اختيارية باستثناء تلك المحددة على أنها مطلوبة. عند اختبار وظيفة API ، نوصي باستخدام ساعي البريد لتبسيط العملية.

URL - رابط الالتقاط.
- مطلوب:
أتش تي أم أل - HTML للتحويل.
- مطلوب:
- عند تحويل HTML ، يجب استخدام HTTP POST.
مفتاح - الخاص بك مفتاح التطبيق.
- مطلوب:
رد - يجب أن يستدعي عنوان URL للمعالج GrabzIt بعد الانتهاء من عمله.
- تعرف على كيفية إنشاء معالج باتباع وثائق كل لغة ASP.NET, جافا, نود.جي إس, بيرل, PHP, بايثون و روبي.
كوستوميد - المعرف المخصص الذي يمكنك ربطه مع الالتقاط.
- سيتم إرجاع هذا مع أي عنوان URL لرد الاتصال الذي حددته.
شكل - الشكل الذي يجب أن يكون به الالتقاط.
- الافتراضي: jpg
- خيارات:
  - bmp8
  - bmp16
  - bmp24
  - BMP
  - CSV
  - GIF
  - أتش تي أم أل
  - JPG
  - جسون
  - قوات الدفاع الشعبي
  - DOCX
  - بابوا نيو غينيا
  - SEO
  - شجار
  - ويب بي
  - XLSX
address - عنوان URL لتنفيذ تعليمات HTML البرمجية فيه. يمكن أن يكون مفيدًا إذا كان HTML الذي يتم تحويله يستخدم عناوين URL النسبية لموارد مثل CSS والصور.
- الافتراضي: فارغ
background - إذا كان هذا صحيحًا ، يجب تضمين خلفية صفحة الويب في PDF
- الافتراضي: 1
- خيارات:
  - 0 = يشير إلى أن وثيقة PDF يجب ألا تتضمن خلفية صفحة الويب
  - 1 = يشير إلى أن وثيقة PDF يجب أن تتضمن خلفية صفحة الويب
background - إذا كان هذا صحيحًا ، يجب تضمين الصور الخلفية لصفحة الويب في DOCX
- الافتراضي: 1
- خيارات:
  - 0 = يشير إلى أن وثيقة DOCX يجب ألا تتضمن الصور الخلفية لصفحة الويب
  - 1 = يشير إلى أن مستند DOCX يجب أن يتضمن صور الخلفية لصفحة الويب
bwidth - عرض المتصفح بالبكسل
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
- الافتراضي: 1366
- الحد الأقصى: 10000
- العرض التلقائي: -1 (تمرير -1 يعني أن عرض المتصفح يطابق عرض المستند)
bheight - ارتفاع المتصفح بالبكسل.
- الافتراضي: 1170
- الحد الأقصى: 10000
- الطول الكامل: -1 (تمرير -1 يعني أنه تم التقاط صورة نصية لصفحة الويب بالكامل)
click - هذا يحدد عنصر HTML ، باستخدام ملف محدد CSS للنقر. تذكر أن التأخير قد يكون مطلوبًا أيضًا لعرض تأثيرات النقرة
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
country - البلد لقطة / القبض ينبغي أن تؤخذ من.
- الافتراضي: الموقع الحالي الأسرع
- الخيارات: "SG" ، "UK" ، "US"
coverurl - عنوان URL لصفحة الويب التي يجب استخدامها كصفحة غلاف لملف PDF
- الافتراضي: فارغ
customwatermarkid - أضف عرف watermark إلى الملف
- الافتراضي: فارغ
delay - عدد المللي ثانية إلى انتظر قبل التقاط لقطة الشاشة
- الافتراضي: 0
- الحد الأقصى: 30000
مدة الأقامة - طول ثواني الفيديو التي يجب تحويلها intيا المتحركة GIF.
- الافتراضي: الحد الأقصى لطول الحزمة
export - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا.
إطارا في الثانية - عدد الإطارات في الثانية التي يجب التقاطها من الفيديو.
- الافتراضي: 10
- الحد الأدنى: 0.2
- الحد الأقصى: 60
hd - إذا كانت الصورة حقيقية سوف يكون التقاط في عالية الوضوح هذا يضاعف حجم أبعاد الصورة.
- الافتراضي: 0
- خيارات:
  - 0 = إنشاء صورة عالية الوضوح
  - 1 = إنشاء صورة عالية الوضوح
height - ارتفاع الصورة المصغرة الناتجة بالبكسل
- الافتراضي: إذا لم يتم تحديد كل من عرض الإخراج وارتفاع الإخراج أو 0 ، فسيتم مطابقة عرض وارتفاع الإخراج مع عرض الصورة النهائية وارتفاعها ، إذا تم تحديد عرض الإخراج ، فسيكون ارتفاع الإخراج متناسبًا مع عرض الإخراج
- الحد الأقصى: أقصى ارتفاع للحزمة
- الطول الكامل: -1 (تمرير -1 يعني أنه لا يتم تقليل ارتفاع الصورة المصغرة)
height - ال ارتفاع مخصص للمستند الناتج في ملم
- الافتراضي: مقاس الصفحه ارتفاع
- الحد الأدنى: 15
ارتفاع - ارتفاع GIF المتحركة الناتجة بالبكسل.
- الافتراضي: 120px
- الحد الأقصى: أقصى ارتفاع للحزمة
- الحجم التلقائي: -1 (تمرير -1 يعني أن ارتفاع يتم تحجيم GIF المتحركة فيما يتعلق بعرضه ، إذا كان الارتفاع يتم تلقائيًا ، فلا يمكن للعرض)
hide - ال محددات CSS واحد أو أكثر من عناصر HTML في صفحة الويب المراد إخفاؤها ، لتحديد عناصر HTML متعددة لإخفاء فصل كل محدد بفاصلة.
- الافتراضي: فارغ
includealltables - إذا كان هذا صحيحًا ، فسيتم استخراج كل جدول في صفحة الويب مع ظهور كل جدول في ورقة بيانات منفصلة.
- متوفر فقط بتنسيق XLSX
- الافتراضي: 0
- خيارات:
  - 0 = يشير إلى أن جميع الجداول لن يتم استخراجها
  - 1 = يشير إلى أنه سيتم استخراج جميع الجداول
includeheadernames - إذا تم إدراج أسماء الرؤوس الحقيقية في الجدول
- الافتراضي: 1
- خيارات:
  - 0 = يشير إلى أن أسماء الرؤوس لن يتم تضمينها في الجدول
  - 1 = يشير إلى أن أسماء الرؤوس سيتم تضمينها في الجدول
includeimages - إذا كان هذا صحيحًا ، يجب تضمين صور صفحة الويب في DOCX
- الافتراضي: 1
- خيارات:
  - 0 = يشير إلى أن وثيقة DOCX لن تتضمن صور صفحات الويب
  - 1 = يشير إلى أن مستند DOCX سيتضمن صور صفحة الويب
includelinks - صحيح إذا كانت الروابط يجب أن تدرج في الوثيقة
- الافتراضي: 1
- خيارات:
  - 0 = يشير إلى أن المستند يجب ألا يتضمن روابط
  - 1 = يشير إلى أن المستند يجب أن يتضمن الروابط
includeoutline - صحيح إذا قوات الدفاع الشعبي الإشارات المرجعية ينبغي أن تدرج
- الافتراضي: 0
- خيارات:
  - 0 = يشير إلى أن وثيقة PDF لن تتضمن مخططًا تفصيليًا
  - 1 = يشير إلى أن وثيقة PDF ستتضمن مخططًا
mergeid - أضف معرف الالتقاط الذي يجب أن يكون دمجها في بداية المستند الجديد
- الافتراضي: فارغ
mtop - الهامش بالمليمترات التي يجب أن تظهر في أعلى صفحة المستند
- الافتراضي: 10
mleft - الهامش بالمليمترات التي يجب أن تظهر على يسار صفحة الوثيقة
- الافتراضي: 10
mbottom - الهامش بالمليمترات التي يجب أن تظهر في أسفل صفحة المستند
- الافتراضي: 10
mright - الهامش بالمليمترات التي يجب أن تظهر على يمين مستند PDF
- الافتراضي: 10
media - ال CSS Media نوع مستند PDF
- الافتراضي: Print
- خيارات:
  - طباعة
  - شاشة
noads - إذا كان هذا صحيحا يجب أن تكون الإعلانات مخفية تلقائيًا.
- الافتراضي: 0
- خيارات:
  - 0 = الإعلانات المعروضة
  - 1 = إخفاء الإعلانات
nonotify - إذا كان هذا صحيحا كل شيء شائع يجب أن تكون إعلامات ملفات تعريف الارتباط مخفية تلقائيًا.
- الافتراضي: 0
- خيارات:
  - 0 = عرض إعلامات ملفات تعريف الارتباط
  - 1 = إخفاء إشعارات ملفات تعريف الارتباط
orientation - اتجاه المستند
- الافتراضي: عمودي
- خيارات:
  - صورة
  - المناظر الطبيعيه
pagesize - حجم صفحة المستند
- الافتراضي: A4
- خيارات:
  - A3
  - A4
  - A5
  - A6
  - B3
  - B4
  - B5
  - B6
  - شروط وأحكام
  - OMG
password - ال كلمة المرور لحماية المستند دوامة
- الافتراضي: فارغ
proxy - تفاصيل وكيل HTTP يجب أن يستخدم برنامج المتصفح لاستخدام هذا الالتقاط
post - أي معلمات مشاركة تريد إرسالها.
quality - ال جودة الالتقاطو JPG و WEBP لديهم ضغط افتراضي بنسبة 90٪ و GIF 85٪. لا تؤثر هذه المعلمة على صور BMP أو PNG أو TIFF.
- إن تقليل الجودة سيقلل حجم الملف ويقلل أوقات التنزيل.
- الافتراضي: -1
- الحد الأدنى: -1
- الحد الأقصى: 100
كرر - عدد مرات تكرار حلقة GIF المتحركة.
- الافتراضي: 0
- حلقة مستمرة: 0
- أبدا التكرار: -1
عكس - إذا كان هذا صحيحًا ، يتم عكس إطارات GIF المتحركة
- الافتراضي: 0
- خيارات:
  - 0 = يشير إلى أن الرسوم المتحركة لن يتم التبجيل بها
  - 1 = يشير إلى أنه سيتم عكس الحركة
requestas - نوع وكيل المستخدم الذي ترغب في استخدامه
- الافتراضي: 0
- خيارات:
  - 0 = يشير إلى أنه يجب إعادة الإصدار القياسي لموقع الويب
  - 1 = يشير إلى النسخة المحمولة من الموقع يجب أن تعاد
  - 2 = يشير إلى أنه يجب إرجاع عرض محرك البحث لموقع الويب
سرعة - سرعة GIF المتحركة.
- الافتراضي: 1
- الحد الأدنى: 0.2
- الحد الأقصى: 10
بداية - موضع بدء الفيديو الذي يجب تحويله intيا المتحركة GIF.
- الافتراضي: 0 ثانية
tabletoinclude - فهرس الجدول المطلوب تحويله ، إذا كانت جميع الجداول في صفحة الويب مرتبة من أعلى صفحة الويب إلى أسفل
- الافتراضي: 1
target - هذه المعلمة تحدد محدد CSS من عنصر HTML الوحيد على صفحة الويب المستهدفة المراد تشغيلها intoa المستند ، يتم تجاهل جميع الأجزاء الأخرى من صفحة الويب. إذا كان هناك عناصر HTML مطابقة متعددة يتم اختيار أول عنصر.
- الافتراضي: فارغ
target - هذه المعلمة تحدد محدد CSS من عنصر HTML الوحيد على صفحة الويب المستهدفة المراد تشغيلها intيا صورة ، يتم تجاهل جميع الأجزاء الأخرى من صفحة الويب. إذا كان هناك عناصر HTML مطابقة متعددة يتم اختيار أول عنصر.
- الافتراضي: فارغ
target - معرف عنصر HTML الوحيد في صفحة الويب التي يجب استخدامها لاستخراج الجداول من
- الافتراضي: فارغ
transparent - إذا كان صحيحا يجب أن يكون التقاط الصور شفافًا. هذا متوافق فقط مع صور بابوا نيو غينيا وتيف.
- الافتراضي: 0
- خيارات:
  - 0 = إنشاء صورة غير شفافة
  - 1 = إنشاء صورة شفافة
templateid - أضف قالب المعرف الذي يحدد رأس وتذييل المستند
- الافتراضي: فارغ
title - تقديم عنوان لمستند PDF
- الافتراضي: فارغ
waitfor - هذا يحدد عنصر HTML ، باستخدام ملف محدد CSS. بمجرد أن العنصر هو مرئية يتم تنفيذ القبض. إذا كان هناك عناصر HTML مطابقة متعددة يتم اختيار أول عنصر. عند استخدام هذه المعلمة ، ستنتظر 25 ثانية كحد أقصى قبل إجراء الالتقاط.
width - عرض الصورة المصغرة الناتجة بالبكسل
- الافتراضي: إذا لم يتم تحديد كل من عرض الإخراج وارتفاع الإخراج أو 0 ، فسيتم مطابقة عرض وارتفاع الإخراج مع عرض الصورة النهائية وارتفاعها ، إذا تم تحديد ارتفاع الإخراج ، فسيكون عرض الإخراج متناسبًا مع ارتفاع الإخراج
- الحد الأقصى: أقصى عرض للحزمة
- العرض الكامل: -1 (تمرير -1 يعني أنه لا يتم تقليل عرض الصورة المصغرة)
width - ال عرض مخصص للمستند الناتج في ملم
- الافتراضي: مقاس الصفحه عرض
- الحد الأدنى: 15
عرض - عرض GIF المتحركة الناتجة بالبكسل.
- الافتراضي: 180px
- الحد الأقصى: أقصى عرض للحزمة
- الحجم التلقائي: -1 (تمرير -1 يعني أن عرض يتم تحجيم GIF المتحركة فيما يتعلق بارتفاعه ، إذا كان حجم العرض تلقائيًا ، فلن يتمكن الارتفاع من ذلك)