API-dokumentation
Har du et spørgsmål? Kontakt os.
Alle API-anmodninger skal foretages via HTTPS og kræver api_key som en URL-forespørgselsparameter.
Eksempel
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
I tilfælde af succes, modtager du et http-svar med status 200 og JSON-info i svarteksten.
{"status":"success","file_url":"https://api.printfriendly.com/downloads/pdf_1531957353_e94df5Letter.pdf"}
API-version
Den aktuelle version af API er 2.0.
Primær API-version skal angives i URL'en som 'v' og nummer, f.eks. v1, v2, v3.
Eksempel
https://api.printfriendly.com/v2/pdf/create
https://api.printfriendly.com/v2/html/create
API-metoder
Metode | Input | Output |
|---|---|---|
PDF / opret | URL / HTML | HTML |
html / opret | URL / HTML |
Parametre
Du skal angive enten page_url eller html parameteren. Alle andre parametre er valgfrie.
Parametre | Værdi |
|---|---|
Side-URL | URL for målsiden |
HTML | HTML-indhold på målside |
Outputtype | Indstil det til "attachment" for at modtage PDF-filen som output i stedet for JSON |
css_url | URL til brugerdefineret CSS-fil |
header_image_url | URL til brugerdefineret headerbillede |
Overskrift tekst | Tekststreng |
Alle eksempler nedenfor er givet for "pdf/create"-metoden og fungerer også for "html/create"-metoden.
Eksempel med page_url-parameter
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>'
Fejl
PrintFriendly bruger konventionelle statuskoder og JSON-svar til at levere fejloplysninger.
Statuskoder
Status | Beskrivelse |
|---|---|
200 OK | Alting fungerer fint. |
400 Forkert anmodning | Der er opstået en fejl. Se detaljer i JSON. |
401 Uautoriseret | 401 Uautoriseret |
404 Ikke fundet | 404 Ikke fundet |
429 For mange forespørgsler | 429 For mange forespørgsler |
Alle ikke succes (ikke Status 200) svar har JSON-krop med fejldetaljer og indeholder fejtype og besked.
Fejltyper
Type | Beskrivelse |
|---|---|
Parameter-validering | Validering af parametre mislykkedes. |
Forbudt domæne | Dette domæne er midlertidigt blokeret. |
Parse mislykkedes | Kan ikke analysere siden. Vi kan ikke bestemme indholdet på denne side. |
Fetch-fejl | Kan ikke hente siden. Tjek, om URL'en er tilgængelig, og prøv igen. |
høj belastning | Validering af parametre mislykkedes. |
Ugyldig filtypenavn | Kun websider understøttes. Det er en PDF/TXT-fil eller et billede (JPG, PNG, GIF). |
stor side | Målside er over 2 MB. Store sider understøttes ikke. |
sikkerhedsplatform | Sikkerhedsplatformen forhindrer os i at hente denne side. |
tidsgrænse | Tidsgrænsen overskredet. Motoren kan ikke behandle siden inden for 30 sekunder. Prøv venligst igen senere. |
altomfattende | Uventet fejl. Prøv igen senere. |
Eksempel
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"}
Begrænsning af anmodningshastighed
API'et har en grænse på 60 forespørgsler pr. minut. Hvis du overskrider denne grænse, får du et svar med Status: 429 For mange forespørgsler.
Overskrift | Beskrivelse |
|---|---|
X-Antalsgrænse | Samlet anmodningsgrænse for den nuværende periode. |
X-RateLimit-Tilbage | Resterende anmodning for den aktuelle periode. |
Nulstil X-RateLimit | Antal sekunder til slutningen af den nuværende periode. |
Eksempel med page_url-parameteren
# 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