צלם תמונות מסך עם ממשק ה- API של RESTful לתמונות המסך שלנו

ממשק ה- API של REST של GrabzIt מאפשר לך לצלם URL או HTML לחלוטין בטכניקות RESTful. לפני שתתחיל, אנא קרא בעיון את ההוראות המפורטות להלן, תלוי במקרה השימוש שלך. אחד מהפתרונות האחרים של ה- API שלנו אולי מתאים יותר.

- חלק מהתכונות כגון מיזוג ותצפית של תצלומים אינן זמינות דרך ממשק ה- REST הזה. כדי להשתמש בתכונות אלה תצטרך להשתמש בתכונה אחרת ספריית API
- אל תשתמש בממשק API זה בצד הלקוח, הוא יחשוף את מפתח היישום שלך! במקום זאת השתמש ב- ממשק API של JavaScript

כדי להתחיל, פשוט בחר מה אתה רוצה לעשות מהמסנן למטה והפרמטרים הזמינים יוצגו יחד עם דוגמה בסיסית.

מה אתה רוצה לעשות?

בבקשה בבקשה וודא את כל ערכי הפרמטרים מקודדים בכתובות אתרים.

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

בעת המרת HTML כל הפרמטרים חייבים להיות פורסם בגוף הבקשה כזוגות מפתח-ערך. ודא שכל ערכי הפרמטרים מקודדים ב-URL, וסוג התוכן הוא יישום / 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 אנו ממליצים להשתמש דוור כדי לפשט את התהליך.

כתובת אתר - כתובת האתר ללכידה.
- דרוש
html - ה- HTML להמרה.
- דרוש
- בעת המרת HTML עליכם להשתמש ב- HTTP POST.
מפתח - שלך מפתח יישום.
- דרוש
תתקשר בחזרה - כתובת האתר של המטפל Grabz זה צריך להתקשר לאחר שסיים את עבודתו.
- גלה כיצד ליצור מטפל על ידי ביצוע התיעוד עבור כל שפה ASP.NET, Java, Node.js, פרל, PHP, פיתון ו אוֹדֶם.
מותאם אישית - המזהה המותאם אישית שאתה יכול לשייך ללכידה.
- זה יוחזר עם כל כתובת אתר להתקשרות חוזרת שציינת.
פוּרמָט - הפורמט שלכידת צריך להיות.
- ברירת מחדל: jpg
- אפשרויות:
  - bmp8
  - bmp16
  - bmp24
  - bmp
  - csv
  - gif
  - html
  - jpg
  - ג'סון
  - PDF
  - docx
  - png
  - SEO
  - רִיב
  - webp
  - xlsx
address - כתובת האתר להוצאת קוד ה- 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", "בריטניה", "ארה"ב"
coverurl - כתובת האתר של דף אינטרנט שיש להשתמש בו כ עמוד שער של ה- PDF
- ברירת מחדל: ריקה
customwatermarkid - הוסף מנהג watermark לקובץ
- ברירת מחדל: ריקה
delay - מספר אלפיות השנייה המתן לפני שתצלם את המסך
- ברירת מחדל: 0
- מרבי: 30000
משך - האורך בשניות של הסרטון שצריך להמיר into אנימציית GIF.
- ברירת מחדל: אורך מקסימאלי לחבילה
export - ה ייצוא URL שמציין לאן יש לייצא גם את הלכידה.
fps - מספר הפריימים בשנייה שצריך לצלם מהסרטון.
- ברירת מחדל: 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 - נכון אם סימניות PDF צריך להיכלל
- ברירת מחדל: 0
- אפשרויות:
  - 0 = מציין שמסמך PDF לא יכלול מתווה
  - 1 = מציין שמסמך PDF יכלול מתווה
mergeid - הוסף את מזהה הלכידה שצריך להיות התמזג בתחילת המסמך החדש
- ברירת מחדל: ריקה
mtop - השוליים במילימטרים שצריכים להופיע בראש דף המסמך
- ברירת מחדל: 10
mleft - השוליים במילימטרים שצריכים להופיע משמאל לדף המסמך
- ברירת מחדל: 10
mbottom - השוליים במילימטרים שצריכים להופיע בתחתית עמוד המסמך
- ברירת מחדל: 10
mright - השוליים במילימטרים שצריכים להופיע מימין למסמך PDF
- ברירת מחדל: 10
media - ה סוג מדיה של CSS של מסמך PDF
- ברירת מחדל: Print
- אפשרויות:
  - קופונים להדפסה
  - מסך
noads - אם זה נכון צריך להסתיר מודעות באופן אוטומטי.
- ברירת מחדל: 0
- אפשרויות:
  - 0 = מודעות לתצוגה
  - 1 = הסתר מודעות
nonotify - אם נכון הכל נפוץ יש להסתיר אוטומטית התראות על עוגיות.
- ברירת מחדל: 0
- אפשרויות:
  - 0 = הצגת התראות קובצי cookie
  - 1 = הסתר התראות קובצי cookie
orientation - כיוון המסמך
- ברירת מחדל: דיוקן
- אפשרויות:
  - דיוקן
  - נוף
pagesize - גודל העמוד של המסמך
- ברירת מחדל: A4
- אפשרויות:
  - A3
  - A4
  - A5
  - A6
  - B3
  - B4
  - B5
  - B6
  - משפטי
  - מִכְתָב
password - ה סיסמא להגנת המסמך עם
- ברירת מחדל: ריקה
proxy - פרטי ה- 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
התחלה - מיקום ההתחלה של הסרטון שצריך להמיר into אנימציית GIF.
- ברירת מחדל: 0 שניות
tabletoinclude - אינדקס הטבלה להמרה, האם כל הטבלאות בעמוד אינטרנט הוזמנו מראש דף האינטרנט למטה
- ברירת מחדל: 1
target - פרמטר זה מציין את בורר CSS של אלמנט ה- HTML היחיד בדף האינטרנט היעד שיש להפוך intמסמך o, כל החלקים האחרים של דף האינטרנט מתעלמים. אם ישנם מספר אלמנטים ב- HTML תואמים, הראשון נבחר.
- ברירת מחדל: ריקה
target - פרמטר זה מציין את בורר CSS של אלמנט ה- HTML היחיד בדף האינטרנט היעד שיש להפוך intoa תמונה, כל החלקים האחרים של דף האינטרנט מתעלמים. אם ישנם רכיבי HTML תואמים מרובים, הראשון מהם נבחר.
- ברירת מחדל: ריקה
target - המזהה של אלמנט ה- HTML היחיד בדף האינטרנט שיש להשתמש בו כדי לחלץ טבלאות מתוך
- ברירת מחדל: ריקה
transparent אם נכון לכידת תמונות צריכה להיות שקופה. זה תואם רק לתמונות png ו- tiff.
- ברירת מחדל: 0
- אפשרויות:
  - 0 = צור תמונה לא שקופה
  - 1 = צור תמונה שקופה
templateid - הוסף תבנית מזהה המציין את הכותרת העליונה והתחתונה של המסמך
- ברירת מחדל: ריקה
title - לספק כותרת למסמך PDF
- ברירת מחדל: ריקה
waitfor - זה מציין את אלמנט ה- HTML, באמצעות א בורר CSS. ברגע שהאלמנט הוא נראה כי הלכידה מבוצעת. אם ישנם רכיבי HTML תואמים מרובים, הראשון מהם נבחר. כאשר משתמשים בפרמטר זה הוא יחכה מקסימום של 25 שניות לפני ביצוע הלכידה.
width - רוחב התמונה הממוזערת שהתקבלה בפיקסלים
- ברירת מחדל: אם רוחב הפלט וגובה הפלט אינם מוגדרים או 0, רוחב הפלט והגובה יתאימו לרוחב ולגובה הסופי של התמונה, אם מוגדר גובה הפלט רוחב הפלט יהיה פרופורציונלי לגובה הפלט
- מקסימום: רוחב מרבי לחבילה
- רוחב מלא: -1 (עובר -1 פירושו שרוחב התמונה הממוזערת לא מצטמצם)
width - ה רוחב מותאם אישית של המסמך שנוצר ב מ"מ
- ברירת מחדל: גודל עמוד רוחב
- מינימום: 15
רוחב - רוחב ה- GIF המונפש שהתקבל בפיקסלים.
- ברירת מחדל: 180px
- מקסימום: רוחב מרבי לחבילה
- גודל אוטומטי: -1 (מעבר -1 פירושו שרוחב ה- GIF אנימציה מוגדלת ביחס לגובה שלו, אם הרוחב מתבצע בגודל אוטומטי הגובה לא יכול)

טיפול בשגיאה

אם יש בעיה כלשהי עם הבקשה ששלחת ל-API, יוחזר אובייקט JSON המסביר את השגיאה. הדרך הטובה ביותר לקבוע זאת היא לבדוק את סוג התוכן של התגובה לפני העיבוד, אם היא application/json אירעה שגיאה. קוד השגיאה שנמצא ב-JSON עוקב אחר ה- רשימה סטנדרטית של קודים.

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