أدوات لالتقاط وتحويل الويب

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

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

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

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

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

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

عند تحويل HTML يجب أن تكون جميع المعلمات نشر في نص الطلب كأزواج ذات قيمة رئيسية. تأكد من ترميز جميع قيم المعلمات URL.

    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.ashx    

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

  • URL - رابط الالتقاط.
    • مطلوب:
  • أتش تي أم أل - HTML للتحويل.
    • مطلوب:
    • عند تحويل HTML ، يجب استخدام HTTP POST.
  • مفتاح - الخاص بك مفتاح التطبيق.
    • مطلوب:
  • رد - يجب أن يستدعي عنوان URL للمعالج GrabzIt بعد الانتهاء من عمله.
  • كوستوميد - المعرف المخصص الذي يمكنك ربطه مع الالتقاط.
    • سيتم إرجاع هذا مع أي عنوان URL لرد الاتصال الذي حددته.
  • شكل - الشكل الذي يجب أن يكون به الالتقاط.
    • الافتراضي: jpg
    • خيارات:
      • bmp8
      • bmp16
      • bmp24
      • BMP
      • CSV
        • يتم تنزيل ملفات CSV تلقائيًا.
      • GIF
      • أتش تي أم أل
        • يتم تنزيل ملفات HTML تلقائيًا.
      • JPG
      • جسون
        • يتم تنزيل ملفات JSON تلقائيًا.
      • قوات الدفاع الشعبي
        • يتم تنزيل ملفات PDF تلقائيًا.
      • DOCX
        • يتم تنزيل ملفات DOCX تلقائيًا.
      • بابوا نيو غينيا
      • شجار
      • ويب بي
      • XLSX
        • يتم تنزيل ملفات XLSX تلقائيًا.
  • address - عنوان URL لتنفيذ تعليمات HTML البرمجية فيه. يمكن أن يكون مفيدًا إذا كان HTML الذي يتم تحويله يستخدم عناوين URL النسبية لموارد مثل CSS والصور.
    • الافتراضي: فارغ
  • background - إذا كان هذا صحيحًا ، يجب تضمين خلفية صفحة الويب في PDF
    • الافتراضي: 1
    • خيارات:
      • 0 = يشير إلى أن وثيقة PDF يجب ألا تتضمن خلفية صفحة الويب
      • 1 = يشير إلى أن وثيقة PDF يجب أن تتضمن خلفية صفحة الويب
  • background - إذا كان هذا صحيحًا ، يجب تضمين الصور الخلفية لصفحة الويب في DOCX
    • الافتراضي: 1
    • خيارات:
      • 0 = يشير إلى أن وثيقة DOCX يجب ألا تتضمن الصور الخلفية لصفحة الويب
      • 1 = يشير إلى أن مستند DOCX يجب أن يتضمن صور الخلفية لصفحة الويب
  • bwidth - عرض المتصفح بالبكسل
    • تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
    • الافتراضي: 1024
    • الحد الأقصى: 10000
    • العرض التلقائي: -1 (تمرير -1 يعني أن عرض المتصفح يطابق عرض المستند)
  • bheight - ارتفاع المتصفح بالبكسل.
    • الافتراضي: 768
    • الحد الأقصى: 10000
    • الطول الكامل: -1 (تمرير -1 يعني أنه تم التقاط صورة نصية لصفحة الويب بالكامل)
  • country - البلد لقطة / القبض ينبغي أن تؤخذ من.
    • تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
    • الافتراضي: الموقع الحالي الأسرع
    • الخيارات: "SG" ، "UK" ، "US"
  • coverurl - عنوان URL لصفحة الويب التي يجب استخدامها كصفحة غلاف لملف PDF
    • الافتراضي: فارغ
  • customwatermarkid - أضف علامة مائية مخصصة إلى الملف
    • الافتراضي: فارغ
  • delay - عدد المللي ثانية إلى انتظر قبل التقاط لقطة الشاشة
    • الافتراضي: 0
    • الحد الأقصى: 30000
  • مدة الأقامة - طول ثواني الفيديو التي يجب تحويلها intيا المتحركة GIF.
    • الافتراضي: الحد الأقصى لطول الحزمة
  • export - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا.
  • filename - تجاوز اسم الملف للملف الذي تم تنزيله
    • صالح فقط حيث يتم تنزيل لقطة الشاشة / الالتقاط
    • الافتراضي: فارغ
  • إطارا في الثانية - عدد الإطارات في الثانية التي يجب التقاطها من الفيديو.
    • الافتراضي: 10
    • الحد الأدنى: 0.2
    • الحد الأقصى: 60
  • hd - إذا كانت الصورة حقيقية سوف يكون التقاط في عالية الوضوح هذا يضاعف حجم أبعاد الصورة.
    • الافتراضي: 0
    • خيارات:
      • 0 = إنشاء صورة عالية الوضوح
      • 1 = إنشاء صورة عالية الوضوح
  • height - ارتفاع الصورة المصغرة الناتجة بالبكسل
    • الإفتراضي: أعلى نسبة لارتفاع المتصفح ممكن أن تتناسب مع أقصى ارتفاع لحزمة المستخدمين
    • الحد الأقصى: أقصى ارتفاع للحزمة
    • الطول الكامل: -1 (تمرير -1 يعني أنه لا يتم تقليل ارتفاع الصورة المصغرة)
  • height - ال ارتفاع مخصص للمستند الناتج في ملم
  • ارتفاع - ارتفاع 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
    • خيارات:
      • 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 و GIF على ضغط افتراضي يبلغ 85٪ و WEBP 80٪. لا تؤثر هذه المعلمة على صور BMP أو PNG أو TIFF.
    • إن تقليل الجودة سيقلل حجم الملف ويقلل أوقات التنزيل.
    • الافتراضي: -1
    • الحد الأدنى: -1
    • الحد الأقصى: 100
  • كرر - عدد مرات تكرار حلقة GIF المتحركة.
    • الافتراضي: 0
    • حلقة مستمرة: 0
  • عكس - إذا كان هذا صحيحًا ، يتم عكس إطارات 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 - عرض الصورة المصغرة الناتجة بالبكسل
    • الإفتراضي: أعلى نسبة من عرض المتصفح ممكن أن تتناسب مع الحد الأقصى للعرض لحزمة المستخدمين
    • الحد الأقصى: أقصى عرض للحزمة
    • العرض الكامل: -1 (تمرير -1 يعني أنه لا يتم تقليل عرض الصورة المصغرة)
  • width - ال عرض مخصص للمستند الناتج في ملم
  • عرض - عرض GIF المتحركة الناتجة بالبكسل.
    • الافتراضي: 180px
    • الحد الأقصى: أقصى عرض للحزمة
    • الحجم التلقائي: -1 (تمرير -1 يعني أن عرض يتم تحجيم GIF المتحركة فيما يتعلق بارتفاعه ، إذا كان حجم العرض تلقائيًا ، فلن يتمكن الارتفاع من ذلك)