Kodirati PDF v Base64
- Nadzorna plošča
- Dokumentacija
- API
Kodirajte PDF v Base64
Base64 je kodiranje, ki binarne podatke predstavlja kot besedilo ASCII (64 znakov: A-Z, a-z, 0-9, plus dva dodatna znaka). Datoteka PDF, ki je binarno po naravi ni mogoče prilepiti neposredno v e-poštno sporočilo HTML, koristno vsebino JSON ali a Atribut XML: najprej ga je treba pretvoriti v besedilo. Naše orodje sprejme vaše PDF in vrne njeno predstavitev Base64, pripravljeno za kopiranje.
Za podrobnosti o Base64 in formatu Data URI na splošno glejte naše kodirnik besedila Base64, ki pokriva načela v globina.
Zakaj kodirati PDF v Base64?
- Vdelajte PDF v e-poštno sporočilo HTML: nekateri e-poštni odjemalci sprejemajo povezave Podatkovni URI ali priloge, kodirane v vrstici MIME.
- Shranite PDF v besedilno polje baze podatkov (stolpec
TEXTaliVARCHAR), ko omejitev aplikacije prepoveduje dvojiški tip (BLOB). - Prenos PDF-ja v uporabniškem tovoru API JSON: JSON ne podpira dvojiškega zapisa, zato mora vsaka datoteka iti skozi Base64.
- Vdelava PDF-ja v podatkovni URL: redka uporaba, rezervirana za zelo mlade datoteke, ker imajo URL-ji omejitve dolžine (običajno 2000 do 8000 znakov odvisno od brskalnika in strežnika).
Format Data URI za PDF
URL vrste Data URI vdela vsebino PDF neposredno v URL:
data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI...
Predpona data:application/pdf;base64, pove brskalniku vrsto in kodiranje MIME.
Ta URL lahko prilepite neposredno v naslovno vrstico sodobnega brskalnika, da ga odprete
PDF ali ga postavite v atribut src ali
.
Konkretni primeri uporabe
- Elektronski podpisi: večina API-jev za podpisovanje (DocuSign, Yousign itd.) sprejmejo ali zahtevajo Base64 PDF v JSON telesu zahteve.
- Varnostne kopije in arhiviranje: serializirajte PDF v izvoz ali datoteko JSON besedilo z različico v git (se je treba izogibati pri velikih količinah, vendar praktično za napeljave test).
- Samodejni testi: integrirajte referenčni PDF neposredno v test enota brez odvisnosti od zunanje datoteke.
- Izvozi odjemalca: ustvarite PDF na strani strežnika, vrnite ga v Base64 v Odgovor JSON, ga odjemalec dekodira in prenese brez dodatnega klica HTTP.
Slabosti, ki se jih je treba zavedati
- Veliki stroški: Base64 doda približno 33 % glasnosti. 1 MB velik PDF postane v Base64 niz 1,37 MB.
- Brez predpomnilnika HTTP: PDF, vdelan v Data URI na strani HTML, je znova prenese ob vsakem nalaganju, za razliko od datoteke, ki je vročena s klasičnega URL-ja z glavami predpomnilnika.
- Omejitve velikosti: pomnilnik brskalnika, največja velikost strani POST
strežnik (
upload_max_filesizeinpost_max_sizev PHP) in kvote baze podatkov (na primer velikost vrstice MySQL) lahko hitro presežete Velik PDF. - Ni primerno za velike datoteke: več kot nekaj MB, raje shramba namenski (S3, disk) in posreduje URL namesto kodirane vsebine.
Kako uporabljati orodje
- Kliknite polje za nalaganje in izberite datoteko PDF.
- Orodje kodira binarno vsebino v Base64 in prikaže rezultat.
- Izberete lahko, ali želite vključiti predpono
data:application/pdf;base64,, odvisno od vaš primer uporabe (s predpono za podatkovni URI, brez predpone za obremenitev JSON). - Kopirajte niz in ga prilepite, kjer ga potrebujete.
Pogosta vprašanja
Kakšna je največja dovoljena velikost PDF?
Omejitev je odvisna od konfiguracije strežnika. V praksi ostanite pod nekaj MB, da jih obdržite brezhibno doživetje. Poleg tega se brskalnik upočasni, odložišče postane nasičeno in cilji (e-pošta, JSON, baza podatkov) lahko zavrnejo tovor.
Ali je Base64 PDF združljiv z e-poštnimi odjemalci (Gmail, Outlook)?
Kot inline kodirana priloga v sporočilu MIME, da: to je celo mehanizem
e-poštni standard. Po drugi strani pa v Data URI v telesu HTML sporočila
( ali ), večina strank
pošta blokira ali prepiše te URL-je iz varnostnih razlogov. Prednostna priloga
klasična.
Kakšna je razlika s šifriranim PDF-jem?
Kodiranje v Base64 ni šifrirano: niz ostane berljiv in trivialen za dekodirati kdorkoli. Šifriran PDF (lastniško ali uporabniško geslo) ostane šifrirano tudi po kodiranju Base64: kodiranje in šifriranje sta dve operaciji neodvisen.
Ali lahko naredim obratno?
Da: uporabite naš dekodirnik PDF Base64 za pretvorite niz Base64 v datoteko PDF, ki jo je mogoče prenesti.
Ali je moj PDF poslan vašim strežnikom?
Kodiranje se obdeluje na strani strežnika za čas trajanja zahteve, nato se datoteka sprosti. Noben trajno shranjevanje se ne izvaja. Za posebej občutljive datoteke PDF izberite a lokalna obdelava z orodjem brez povezave.
Primer zahteve
curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
-F "file=@/path/to/file"
Vhodna shema
| Polje | Tip | Obvezno | Privzeto |
|---|---|---|---|
file |
file | ✓ | – |
to orodje pričakuje datoteko - uporabite Content-Type multipart/form-data namesto application/json
Končne točke
GET https://cdrn.fr/api/v1/tools- izpiše vsa razpoložljiva orodjaGET https://cdrn.fr/api/v1/tools/base64-pdf-encoder- pridobi shemo tega orodjaPOST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute- izvede to orodje s JSON payloadom