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

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

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

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

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

عند تقديم الطلبات يرجى التأكد من جميع قيم المعلمات هي 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 - عنوان URL للالتقاط.
- مطلوب:
أتش تي أم أل - تحويل HTML.
- مطلوب:
- عند تحويل HTML ، يجب عليك استخدام HTTP POST.
مفتاح - لك مفتاح التطبيق.
- مطلوب:
رد - عنوان URL لمعالج GrabzIt يجب أن يستدعي بعد انتهاء عمله.
- تعرف على كيفية إنشاء معالج باتباع الوثائق الخاصة بكل لغة ASP.NET, جافا, نود.جي إس, بيرل, PHP, بايثون و روبي.
كوستوميد - المعرف المخصص الذي يمكنك ربطه بالتقاط الصور.
- سيتم إرجاع هذا مع أي عنوان URL لمعاودة الاتصال حددته.
شكل - التنسيق الذي يجب أن يكون عليه الالتقاط.
- الافتراضي: jpg
- خيارات:
  - bmp8
  - bmp16
  - bmp24
  - BMP
  - CSV
  - GIF
  - أتش تي أم أل
  - JPG
  - جسون
  - قوات الدفاع الشعبي
  - DOCX
  - بابوا نيو غينيا
  - SEO
  - شجار
  - mp4
  - ويب بي
  - 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 or تختص watermark إلى الملف
- الافتراضي: فارغ
delay - عدد المللي ثانية إلى انتظر قبل التقاط لقطة الشاشة
- الافتراضي: 0
- الحد الأقصى: 30000
مدة الأقامة - طول ثواني الفيديو التي يجب تحويلها intيا المتحركة GIF.
- الافتراضي: الحد الأقصى لطول الحزمة
مدة الأقامة - يجب تسجيل طول صفحة الويب بالثواني.
- الافتراضي: 10
- الحد الأقصى: 30
export - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا.
إطارا في الثانية - عدد الإطارات في الثانية التي يجب التقاطها.
- الافتراضي: 10
- الحد الأدنى: 0.2
- الحد الأقصى: 60
إطارا في الثانية - عدد الإطارات في الثانية التي يجب التقاطها.
- الافتراضي: 1
- الحد الأدنى: 0.2
- الحد الأقصى: 10
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 ثانية
بداية - وقت البدء بالثواني بعد التحميل الذي يجب التقاط الفيديو منه.
- الافتراضي: 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 المتحركة فيما يتعلق بارتفاعه ، إذا كان حجم العرض تلقائيًا ، فلن يتمكن الارتفاع من ذلك)

بيانات المستخدم

احصل على باقة حسابك الجاري والرصيد المتبقي من خلال هذه المكالمة البسيطة.

    https://api.grabz.it/services/user?key=Sign in to view your Application Key

معالجة الأخطاء

إذا كانت هناك مشكلة في الطلب الذي قدمته إلى واجهة برمجة التطبيقات ، فسيتم إرجاع كائن JSON موضحًا الخطأ. أفضل طريقة لتحديد ذلك هي التحقق من نوع محتوى الاستجابة قبل معالجتها ، إذا كانت application/json حدث خطأ. رمز الخطأ الموجود في JSON يتبع قائمة الرموز القياسية.

{
    "Result": false,
    "Code":"URL is missing",
    "Message":100
}