የAPI ሰነዶች

እንደምን አለ? አንካሩን ያግኙ።

ሁሉንም የኤፒአይ ጥያቄዎች በ HTTPS ላይ መደረግ አለበት እና api_key እንደ ዩአርኤል ጥያቄ ፋርሜተር ይፈልጋል።

ምሳሌ

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

በ ስኬት ጊዜ፣ ከሁኔታ 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 ዘዴዎች

ዘዴ	ግቤት	ውጤት
ፒዲኤፍ / ፍጠር	URL / HTML	HTML
html / ፍጠር	URL / HTML	ፒዲኤፍ

መለኪያዎች

እቅፍ ወይም html መካከለኛ ማቅረብ ይኖርብዎታል። አንዳንድ ሌሎች መካከለኞች ነጻ ናቸው።

መለኪያዎች	እናት
የገፅ አድራሻ	የአሰባሰቢው ገጽ አድራሻ
HTML	የነግረአንድ HTML ይዘት
ውጤት አይነት	አስቀመጡት በ "አባሪ" ላይ እንደ PDF ፋይል ከ JSON ማንሳት ይቀበሉ
css_url	URL የራስዎ ሆነው CSS ፋይል
header_image_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 input

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 በተለምዶ Status ኮዶች እና JSON ምላሽን ለስህተት ዝርዝር ማቅረብ ይጠቀማል።

የሁኔታ ኮድ

ሁኔታ	መግለጫ
200 ማረጋገጥ	ነገር ሁሉ በትክክል ይሠራል።
400 የተመነጠለ ጥያቄ	በስህተት አላለ። ዝርዝሮችን በ JSON ውስጥ እይ።
401 የማይፈቀድ	401 የማይፈቀድ
ፋውንድ አልተገኘም 404	ፋውንድ አልተገኘም 404
429 ጠቅላላ ጥያቄዎች ብዛት	429 ጠቅላላ ጥያቄዎች ብዛት

ሁሉም ተሳክቷል አይደለም (አይሆን Status 200) የምላሽ ክፍል JSON body ከስህተት ዝርዝር ጋር እና የስህተት አይነት እና መልእክትን ማካተትን እንዲካተትት。

እቅፍ አይነቶች

ዓይነት	መግለጫ
መተኮሻዎች ማረጋገጥ	አማካይነት እቅፍ ያልተሳካ።
ተከልካል የስርዓት ድር	ይህ ድር ማለት ጊዜዊ እቅፍ ተብሏል።
አልተተረጉሙም	ይቅርታ ገጽን ማሳወቅ አልቻልንም። የዚህ ገጽ ፍጥረት መወሰን አልቻልንም።
እርምጃ ስላይኖረ	የገጹን መስተዋል አልቻልኩም። URL እንደሚደረሰ እንደሆነ ያረጋግጡ እና እንደገና ይሞክሩ።
ባለ ጭነት ከፍተኛ	የአማካኝ ማረጋገጫ አልተሳካም።
የፋይል አርዳዳ ልቁታ	የድር ገጽዎች ብቻ ናቸው የተደጋገሙ። እነዚህ የ PDF/TXT ፋይል ወይም ምስሎች (JPG, PNG, GIF) ናቸው።
ትልቅ ገጽ	የታሪክ ገጽ ከ 2 ሜጋ ባይት ይበልጣል። ትልቅ ገጾች አይደገጉም።
የደህንነት መድረክ	የፈጠራ መድረክ እነዚህን ገጽ እንዳይወስድ ያስቆምታል።
የጊዜ አልቋሽ	ጊዜው አበስተካከለ። ኔምጂን ገፁን በ 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 input

# 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"}

የጥያቄዎች ደረጃ አስቀመጥ

ኤፒአይ በደቂቃ 60 ጥያቄዎች ያለው አቅርቦት አለው። ይህንን ወሰን ከበለጠን ምላሽ ጋር ምንም Status: 429 በጣም ብዙ ጥያቄዎች እንደታገኝ ትረከባለህ።

አርዕስት	መግለጫ
ኤክስ-የተገደበ-ምርት	አጠቃላይ ጥያቄዎች መጠን ለወቅታዊ ጊዜ.
X-የተወሰነ-ቀሪ	የአሁኑ ጊዜ ተቀርቶ ትእዛዝ.
የ-X እንቅስቃሴ ውስብስብነት እንደገና አውልቅ	በአሁኑ ጊዜ ያለው ጊዜአቀማመጥ መጨረሻንም ከማህበረሰቡ ጊዜ እንድትቆጠራት የቀረ ሚያንሰው ሰከንዶች ብዛት።

ናሁና በ 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

ጀምር በነፃ

አነስ ያቀናበሱት ነጻ ነው እና የክሬዲት ካርድ አስፈላጊ አይደለም። ምንም ጥያቄ ካሎት ያነጋግሩን።