eDeazyCV Documents
controleren…

API-referentie

Base URL:

Viewer-URL's

Voor integratie in ng-front. De client bouwt alleen de URL; de service haalt de bron-HTML op bij Talentpool, rendert PDF of DOCX en toont of downloadt het resultaat. Geen API-key nodig. instance en uid accepteren [A-Za-z0-9._-].

https://documents.eazycv.com/{output}/{instance}/{uid}?environment={env}&filename={name}
ParameterVerplichtBeschrijving
outputjapdf-view (PDF) of docx-view (Word).
instancejaTenant/template, bijv. ict-nl.
uidjaCV-uid van het document.
environmentaccacc → tp.acc.eazycv.com. Anders tp.eazycv.com.
filenameneeDownloadnaam. Extensie wordt aangevuld. Fallback: {instance}-{uid}.{ext}.
debugnee1 toont frames, timing en debugrapport.
betaneetrue voegt ?beta=true toe aan de bron-URL.
plainmodeneetrue voegt ?plainmode=true toe aan de bron-URL.

Outputtypes

RouteBronGedrag
/pdf-view/{instance}/{uid} {tp}/pdf/{instance}/{uid} PDF.js-viewer (zoom, print, download). Te gebruiken als iframe src of nieuw tabblad.
/docx-view/{instance}/{uid} {tp}/pdf/{instance}/{uid}?word=true Genereert .docx, start download, biedt Open in Word. Via window.open, niet in een iframe.

Voorbeelden

VariantURL
PDF · prodhttps://documents.eazycv.com/pdf-view/{instance}/{uid}?filename=Jan-Jansen.pdf
PDF · acchttps://documents.eazycv.com/pdf-view/{instance}/{uid}?environment=acc&filename=Jan-Jansen.pdf
Word · prodhttps://documents.eazycv.com/docx-view/{instance}/{uid}?filename=Jan-Jansen.docx
Word · acchttps://documents.eazycv.com/docx-view/{instance}/{uid}?environment=acc&filename=Jan-Jansen.docx
Query-variant/pdf-view?instance={instance}&uid={uid}&environment=acc

Encodeer path- en query-waarden met encodeURIComponent. De bron-HTML (https://tp.eazycv.com/pdf/{instance}/{uid}) is input voor deze service en geen eindgebruikers-URL.

Endpoints

RouteAuthBeschrijving
GET /health—Liveness. Retourneert status, timestamp en adobeConfigured.
POST /generate-pdfX-API-KeyHTML-URL naar PDF. JSON, max 15 MB.
POST /generate-docxX-API-KeyPDF of HTML-URL naar DOCX via Adobe. 503 zonder Adobe-credentials.
GET /pdf-view/{instance}/{uid}—PDF-viewer. Zie Viewer-URL's.
GET /docx-view/{instance}/{uid}—Word-download. Zie Viewer-URL's.

Authenticatie

API-routes vereisen de header X-API-Key met de waarde van PDF_API_KEY. Is PDF_API_KEY leeg, dan zijn de routes open. Een ongeldige sleutel geeft 401.

/benchmark gebruikt Basic Auth: gebruiker BENCHMARK_USER (default benchmark), wachtwoord BENCHMARK_PASSWORD met fallback op PDF_API_KEY.

HTTP
POST /generate-pdf
Content-Type: application/json
X-API-Key: <PDF_API_KEY>

Request body

Voor /generate-pdf is alleen url verplicht. Puppeteer-opties kunnen plat (width, marginTop) of genest onder data.pdf_settings worden meegegeven. Layout-CSS/JS hoort onder data.layout. Zonder formaat wordt A4 gebruikt. Met preferCSSPageSize heeft CSS @page voorrang op width/height.

VeldTypeDefaultBeschrijving
urlstring—Bronpagina.
formatstringA4Papierformaat als width/height ontbreken.
width / heightstring210mm / 297mmExacte paginamaat.
landscapeboolfalseLiggende oriëntatie.
printBackgroundbooltrueAchtergrondkleuren en -afbeeldingen renderen.
omitBackgroundboolfalseWitte pagina-achtergrond weglaten.
preferCSSPageSizeboolfalse@page bepaalt de maat, tenzij width+height gezet zijn.
scalenumber1Renderschaal.
marginTop…Leftstring0mmMarges met eenheid (mm, cm, px).
displayHeaderFooterboolfalseChromium header/footer-templates tonen.
headerTemplate / footerTemplatestring""HTML voor kop- en voettekst.

pdf_settings & layout

data.pdf_settings en data.layout worden ook op topniveau geaccepteerd. De response bevat in data.applied wat daadwerkelijk is toegepast: bron-URL, PDF-opties, geïnjecteerde CSS/JS, Paged.js-status en waarschuwingen.

VeldVerwerking
pdf_settings.page.width/heightPaginamaat. Getallen zonder eenheid worden mm.
pdf_settings.margins.*Puppeteer-marges; staan los van CSS @page-marges.
other.landscape / scale / printBackground / omitBackgroundDirect naar page.pdf(). true, 1 en "yes" gelden als aan.
other.preferCSSPageSizeBij true wint CSS @page; width/height blijven fallback.
other.displayHeaderFooter + templatesChromium kop/voet. Lege templates blijven leeg.
layout.version / use_version2Selecteert *_beta CSS/JS. Lege beta valt terug op stable.
css_html, css_pdf (+ _beta)Na navigatie geïnjecteerd, in die volgorde. <style>-wrappers worden verwijderd.
css_word (+ _beta)Alleen bij HTML→DOCX; genegeerd bij PDF-output.
custom_javascript (+ _beta)Uitgevoerd na CSS-injectie, vóór Paged.js.
use_pagedjstrue: wacht op previewDone (max 30 s). false: overslaan. Headers/footers via Paged.js CSS; zet displayHeaderFooter dan op false.
layout.settingsPaginaformaat en marges → @page. Kleuren, typografie en structuur → CSS-variabelen --layout-*.
custom_template_nameAlleen gelogd; het template zit in de bron-URL.

DOCX

POST /generate-docx ondersteunt twee bronnen. Default is een bestaande PDF. Met source: "html" rendert Chromium eerst een PDF, die vervolgens door Adobe naar DOCX wordt geëxporteerd.

VeldTypeDefaultBeschrijving
sourcestringpdfpdf of html.
urlstring—PDF-URL (source=pdf) of HTML-URL (source=html).
pdfBase64string—PDF als base64; alternatief voor url bij source=pdf.
ocrLangstringnl-NLOCR-taal voor de Adobe-export.

Bij source=html gelden alle velden van /generate-pdf. Configuratie: ADOBE_CLIENT_ID, ADOBE_CLIENT_SECRET, optioneel ADOBE_API_URL (default https://pdf-services.adobe.io).

Response

200 OK
{
  "status": "success",
  "data": {
    "base64file": "JVBERi0xLjc...",
    "duration": 1.42,
    "requestId": "a1b2c3d4e5f6",
    "applied": { /* toegepaste pdf- en layoutinstellingen */ },
    "timings": { /* navigateMs, fontsMs, pagedjsMs, pdfMs, pages, localAssets */ }
  }
}
VeldBeschrijving
base64filePDF- of DOCX-bestand, base64-gecodeerd.
durationTotale verwerkingstijd in seconden.
requestIdCorrelatie-ID voor logs en error-screenshots.
appliedPer veld: geïnjecteerd, overgeslagen of fallback.
timingsDuur per fase: navigatie, fonts, Paged.js, page.pdf().

Statuscodes en timeouts

CodeBetekenis
400Geen bron opgegeven.
401Ontbrekende of ongeldige X-API-Key.
500Navigatie-, render- of exportfout. Bevat error en requestId.
503Adobe PDF Services niet geconfigureerd.

Timeouts: navigatie 45 s, PDF-generatie 30 s, Adobe-polling max 90 s.

Voorbeelden

Postman-collectie (v2.1) met variabelen baseUrl en apiKey: download .json.

/generate-pdf
curl -sS /generate-pdf \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $PDF_API_KEY" \
  -d '{
    "url": "https://example.com/document",
    "width": "210mm",
    "height": "297mm",
    "printBackground": true
  }'
/generate-docx
curl -sS /generate-docx \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $PDF_API_KEY" \
  -d '{
    "source": "html",
    "url": "https://example.com/document",
    "width": "210mm",
    "height": "297mm",
    "ocrLang": "nl-NL"
  }'