CDRN

Koodaa PDF Base64:ksi

  • Hallintapaneeli
  • Dokumentaatio
  • API
muuntaa PDF:n Base64 / Data URI -merkkijonoksi, ihanteellinen dokumentin upottamiseen suoraan HTML:ään, JSON:iin tai sähköpostiin

Koodaa PDF Base64-muotoon

Base64 on koodaus, joka esittää binaaridataa ASCII-tekstinä (64 merkkiä: A-Z, a-z, 0-9 sekä kaksi lisämerkkiä). PDF-tiedostoa, joka on luonnostaan binaarinen, ei voi liittää suoraan HTML-sähköpostiin, JSON-hyötykuormaan tai XML-attribuuttiin: se on ensin muunnettava tekstiksi. Työkalumme ottaa PDF-tiedostosi ja palauttaa sen Base64-esityksen, joka on valmis kopioitavaksi.

Lisätietoja Base64-koodauksesta ja Data URI -muodosta yleensä löydät Base64-tekstikooderistamme, jossa periaatteet käydään läpi perusteellisesti.

Miksi PDF koodataan Base64-muotoon ?

  • PDF:n upottaminen HTML-sähköpostiin : jotkut sähköpostiohjelmat hyväksyvät Data URI -linkit tai MIME-muotoon upotetut liitteet.
  • PDF:n tallentaminen tietokannan tekstikenttään (sarake TEXT tai VARCHAR), kun sovelluksen rajoitukset estävät binaarityypin (BLOB) käytön.
  • PDF:n välittäminen API:n JSON-hyötykuormassa : JSON ei tue binaaridataa, joten tiedostot on siirrettävä Base64-muodossa.
  • PDF:n upottaminen data-URL-osoitteeseen: harvinainen käyttötapa, jota kannattaa käyttää vain hyvin pienille tiedostoille, koska URL-osoitteilla on pituusrajoituksia (tyypillisesti 2000–8000 merkkiä selaimesta ja palvelimesta riippuen).

PDF-tiedoston Data URI -muoto

Data URI -tyyppinen URL upottaa PDF:n sisällön suoraan URL-osoitteeseen: 

data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI...

Etuliite data:application/pdf;base64, kertoo selaimelle MIME-tyypin ja koodauksen. Voit liittää tämän URL:n suoraan nykyaikaisen selaimen osoitepalkkiin avataksesi PDF:n tai sijoittaa sen <iframe>- tai <embed>-elementin src-attribuuttiin.

Konkreettisia käyttötapauksia

  • Sähköiset allekirjoitukset : useimmat allekirjoitus-API:t (kuten DocuSign, Yousign jne.) hyväksyvät tai vaativat PDF:n Base64-muodossa pyynnön JSON-rungossa.
  • Varmuuskopiot ja arkistointi : PDF:n sarjallistaminen JSON-vientiin tai git-versioituun tekstitiedostoon (vältettävä suurilla määrillä, mutta kätevä testiaineistoille).
  • Automatisoidut testit : viite-PDF:n upottaminen suoraan yksikkötestiin ilman riippuvuutta ulkoisesta tiedostosta.
  • Asiakasviennit : luo PDF palvelimella, palauta se Base64-muodossa JSON-vastauksessa, jolloin asiakas purkaa ja lataa sen ilman ylimääräistä HTTP-pyyntöä.

Huomioitavat haittapuolet

  • Koon kasvu : Base64 lisää kokoa noin 33 %. 1 megatavun PDF:stä tulee 1,37 megatavun merkkijono Base64-muodossa.
  • Ei HTTP-välimuistia : HTML-sivulle Data URI -muodossa upotettu PDF ladataan joka kerta uudelleen, toisin kuin perinteisen URL-osoitteen kautta välimuistiotsakkeilla tarjottava tiedosto.
  • Kokorajoitukset : selaimen muisti, palvelinpään POST-viestin enimmäiskoko (kuten PHP:n upload_max_filesize ja post_max_size) sekä tietokannan rajoitukset (esim. MySQL:n rivikoko) voivat tulla nopeasti vastaan suurten PDF-tiedostojen kohdalla.
  • Ei sovellu suurille tiedostoille : jos tiedostokoko on yli muutaman megatavun, suosi erillistä tallennustilaa (S3, levy) ja välitä URL-osoite koodatun sisällön sijaan.

Miten työkalua käytetään

  1. Napsauta latauskenttää ja valitse PDF-tiedostosi.
  2. Työkalu koodaa binaarisisällön Base64-muotoon ja näyttää tuloksen.
  3. Voit valita, sisällytetäänkö etuliite data:application/pdf;base64, käyttötapauksesi mukaan (etuliitteellä Data URI:lle, ilman etuliitettä JSON-hyötykuormalle).
  4. Kopioi merkkijono ja liitä se sinne, missä sitä tarvitset.

Usein kysyttyjä kysymyksiä

Mikä on suurin hyväksytty PDF-koko ?

Raja riippuu palvelimen asetuksista. Käytännössä kannattaa pysyä muutamassa megatavussa sujuvan käyttökokemuksen varmistamiseksi. Tätä suuremmat koot hidastavat selainta, täyttävät leikepöydän ja saattavat johtaa hylkäykseen vastaanottopäässä (sähköposti, JSON, tietokanta).

Onko Base64-PDF yhteensopiva sähköpostiohjelmien (kuten Gmail, Outlook) kanssa ?

MIME-viestiin upotettuna liitteenä kyllä: se on jopa sähköpostin standardimekanismi. Sen sijaan viestin HTML-rungossa olevana Data URI -linkkinä (<a href="data:..."> tai <iframe>) useimmat sähköpostiohjelmat estävät tai muokkaavat nämä URL-osoitteet turvallisuussyistä. Suosi perinteistä liitettä.

Mitä eroa on koodatulla ja salatulla PDF-tiedostolla ?

Base64-koodaus ei ole salausta : merkkijono on luettavissa ja kuka tahansa voi purkaa sen helposti. Salattu PDF (omistaja- tai käyttäjäsalasana) säilyy salattuna myös Base64-koodauksen jälkeen: koodaus ja salaus ovat kaksi toisistaan riippumatonta toimenpidettä.

Voinko tehdä päinvastaisen operaation ?

Kyllä: käytä Base64-PDF-purkuamme muuntaaksesi Base64-merkkijonon ladattavaksi PDF-tiedostoksi.

Lähetetäänkö PDF-tiedostoni palvelimillenne ?

Koodaus käsitellään palvelimella pyynnön ajan, jonka jälkeen tiedosto vapautetaan. Pysyvää tallennusta ei tehdä. Erityisen arkaluonteisten PDF-tiedostojen kohdalla suosi paikallista käsittelyä offline-työkalulla.

Pyyntöesimerkki

curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
  -F "file=@/path/to/file"

Syöteskeema

Kenttä Tyyppi Pakollinen Oletus
file file ✓ –

tämä työkalu odottaa tiedostoa - käytä Content-Type multipart/form-data:a application/json:in sijaan

Päätepisteet

  • GET https://cdrn.fr/api/v1/tools - listaa kaikki saatavilla olevat työkalut
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - hakee tämän työkalun skeeman
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - suorittaa tämän työkalun JSON-payloadilla