תיעוד API

יש לך שאלה? צור קשר.

כל בקשות ה-API חייבות להתבצע באמצעות HTTPS ודורשות api_key כפרמטר שאילתה URL.

דוגמה

curl https://api.printfriendly.com/v2/pdf/create?api_key=YOUR_API_KEY /

-H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' /

-d page_url=https://en.wikipedia.org/wiki/Eclipse

במקרה של הצלחה, תקבל תגובת http עם סטטוס 200 ומידע JSON בגוף התגובה.

{"status":"success","file_url":"https://api.printfriendly.com/downloads/pdf_1531957353_e94df5Letter.pdf"}

גרסת ה-API

הגרסה הנוכחית של API היא 2.0.

גרסת API מרכזית חייבת להינתן ב-URL כ-'v' ומספר, לדוגמה v1, v2, v3.

דוגמה

https://api.printfriendly.com/v2/pdf/create

https://api.printfriendly.com/v2/html/create

שיטות API

שיטה	קלט	פלט
PDF / צור	URL / HTML	HTML
html / צור	URL / HTML	PDF

פרמטרים

עליך לספק פרמטר page_url או html. כל שאר הפרמטרים הם אופציונליים.

פרמטרים	ערך
כתובת עמוד	כתובת ה-URL של דף היעד
HTML	תוכן HTML של דף היעד
סוג פלט	הגדר זאת ל"קובץ מצורף" כדי לקבל את קובץ ה-PDF כקלט במקום JSON
css_url	כתובת URL לקובץ CSS מותאם אישית
header_image_url	כתובת URL לתמונה מותאמת אישית בכותרת
טקסט כותרת	מחרוזת טקסט

כל הדוגמאות למטה מסופקות עבור השיטה "pdf/create" ועובדות גם עבור השיטה "html/create".

דוגמה עם פרמטר page_url

curl https://api.printfriendly.com/v2/pdf/create?api_key=YOUR_API_KEY /

-H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' /

-d page_url=https://test.test /

-d css_url=https://my-site.com/pdf_style.css /

-d header_text='My Custom Header'

קלט HTML

curl https://api.printfriendly.com/v2/pdf/create?api_key=YOUR_API_KEY /

-H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' /

-d html='<html><body><h1>Title</h1><p>Text text text text text text text text text</p></body></html>'

שגיאות

PrintFriendly משתמש בקודי סטטוס קונבנציונליים ובתגובת JSON כדי לספק פרטי שגיאה.

קודי מצב

סטטוס	תיאור
200 בסדר	הכל עובד בסדר.
400 בקשה שגויה	אירעה שגיאה. ראה פרטים ב-JSON.
401 לא מורשה	401 לא מורשה
404 לא נמצא	404 לא נמצא
429 יותר מדי בקשות	429 יותר מדי בקשות

כל לא מוצלח (לא סטטוס 200) התגובות מכילות גוף JSON עם פרטי השגיאה וכוללות את סוג השגיאה וההודעה.

סוגי שגיאות

סוג	תיאור
אימות פרמטרים	אימות הפרמטרים נכשל.
תחום אסור	הדומיין הזה נחסם באופן זמני.
שגיאה בניתוח	לא ניתן לנתח את הדף. איננו יכולים לקבוע את התוכן של דף זה.
שגיאת אחזור	לא ניתן לאחזר את העמוד. בדוק שהכתובת URL נגישה ונסה שוב.
עומס גבוה	בדיקת הפרמטרים נכשלה.
סיומת קובץ לא חוקית	רק דפי אינטרנט נתמכים. זהו קובץ PDF/TXT או תמונה (JPG, PNG, GIF).
עמוד גדול	דף היעד גדול מ-2MB. דפים גדולים אינם נתמכים.
פלטפורמת אבטחה	הפלטפורמה האבטחתית חוסמת אותנו מלגשת לעמוד זה.
פסק זמן	פג זמן ההמתנה. המנוע אינו יכול לעבד את הדף בתוך 30 שניות. אנא נסה שנית מאוחר יותר.
הכולל	שגיאה לא צפויה. אנא נסה שוב מאוחר יותר.

דוגמה

curl https://api.printfriendly.com/v2/pdf/create?api_key=YOUR_API_KEY /

-H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' /

-d page_url=https://test.test

קלט HTML

# HTTP RESPONSE

# HEADERS (some of headers were ommited)

Content-Type: application/json; charset=utf-8/

Status: 400 Bad Request

# BODY (JSON)

{"status":"failed","message":"Print technology unable to download or parse content"}

הגבלת קצב בקשות

ל-API יש הגבלה של 60 בקשות לדקה. אם תחרוג ממגבלה זו, תקבל תשובה עם סטטוס: 429 יותר מדי בקשות.

כותרת	תיאור
X-מגבלת קצב	מגבלת סך הבקשות לתקופה הנוכחית.
X-סף-נותר	בקשה שנותרה לתקופה הנוכחית.
איפוס X-RateLimit	כמות שניות עד לסיום התקופה הנוכחית.

דוגמה עם הפרמטר page_url

# HEADERS (some of headers were ommited)

Status: 429 Too Many Requests

X-RateLimit-Limit: 60

X-RateLimit-Remaining: 0

X-RateLimit-Reset: 20

# BODY (JSON)Empty

התחל בחינם

נסו את זה בחינם ואין צורך בכרטיס אשראי. צרו קשר לאי אלו שאלות.