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

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

REST API

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

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

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

يوجد أدناه عنوان URL لواجهة برمجة التطبيقات، والذي يتم استخدامه لجميع استدعاءات REST API. عند تقديم الطلبات يرجى التأكد من جميع قيم المعلمات هي URL المشفرة.

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

يوجد أدناه عنوان URL لواجهة برمجة التطبيقات، والذي يتم استخدامه لجميع استدعاءات REST API. عند تحويل 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 ، نوصي باستخدام ساعي البريد لتبسيط العملية.

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

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

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

شاشات الويب

إضافة مراقب

أضف عنوان URL لمراقبته من تطبيقك من خلال هذه المكالمة السهلة. سيؤدي هذا إلى إرجاع كائن JSON لشاشة الويب بما في ذلك معرفه.

    https://api.grabz.it/services/monitor?key=Sign in to view your Application Key&url=https://www.astropioneer.blog&email=hello@example.com&repeat=60&cssselector=%23id1

حذف مراقب

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

    https://api.grabz.it/services/monitor/[Monitor ID]/?key=Sign in to view your Application Key

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

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

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