mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
This commit is contained in:
SnapOtter
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "PDF-pagina's ordenen om te vouwen tot een boekje."
|
||||
i18n_source_hash: 8844b6d4fe96
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 961e8f8f4017
|
||||
---
|
||||
|
||||
# Boekje-PDF {#booklet-pdf}
|
||||
|
||||
Schik pagina's in voor dubbelzijdig printen zodat de gedrukte vellen tot een boekje kunnen worden gevouwen.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/booklet-pdf`
|
||||
|
||||
Accepteert multipart form data met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| perSheet | integer | Nee | `2` | Pagina's per vel: `2`, `4`, `6` of `8` |
|
||||
|
||||
## Voorbeeldverzoek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/booklet-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"perSheet": 2}'
|
||||
```
|
||||
|
||||
## Voorbeeldrespons {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2400000
|
||||
}
|
||||
```
|
||||
|
||||
## Opmerkingen {#notes}
|
||||
|
||||
- De standaard `perSheet: 2` plaatst twee pagina's naast elkaar op elk vel, wat de standaard boekjeslay-out is voor dubbelzijdig printen.
|
||||
- Blanco pagina's worden automatisch toegevoegd als het totale aantal pagina's geen veelvoud is van de velgrootte.
|
||||
- Print de uitvoer dubbelzijdig met binding aan de korte zijde, vouw daarna en niet.
|
||||
@@ -0,0 +1,62 @@
|
||||
---
|
||||
description: "Verklein de bestandsgrootte van een PDF door ingebedde afbeeldingen te comprimeren."
|
||||
i18n_source_hash: a8bb0baaca25
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 51fa6d44d483
|
||||
---
|
||||
|
||||
# Compress PDF {#compress-pdf}
|
||||
|
||||
Verklein de bestandsgrootte van een PDF door ingebedde afbeeldingen te downsamplen. Kies tussen een kwaliteitsschuif of een doelbestandsgrootte.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/compress-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | Nee | `"quality"` | Compressiemodus: `quality` of `targetSize` |
|
||||
| quality | integer | Nee | `75` | Compressiekwaliteit, 1-100 (hoger = minder compressie). Gebruikt in de modus `quality` |
|
||||
| targetSizeKb | number | Nee | - | Doelbestandsgrootte in kilobytes. Gebruikt in de modus `targetSize` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
Comprimeren op kwaliteit:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/compress-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"mode": "quality", "quality": 60}'
|
||||
```
|
||||
|
||||
Comprimeren naar een doelgrootte:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/compress-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"mode": "targetSize", "targetSizeKb": 500}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 5200000,
|
||||
"processedSize": 1800000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- In de modus `quality` produceren lagere waarden kleinere bestanden met meer beeldkwaliteitsverlies.
|
||||
- In de modus `targetSize` vindt een binaire zoekopdracht de hoogste DPI die binnen de gevraagde grootte past.
|
||||
- Als compressie het bestand zou vergroten, worden de originele bytes ongewijzigd teruggegeven.
|
||||
- Tekst en vectorinhoud worden niet beïnvloed; alleen ingebedde rasterafbeeldingen worden gedownsampled.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Snijd alle pagina's van een PDF bij met een uniforme marge."
|
||||
i18n_source_hash: ffa1a2cee08d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7698e91a8208
|
||||
---
|
||||
|
||||
# Crop PDF {#crop-pdf}
|
||||
|
||||
Snijd alle pagina's van een PDF bij door een uniforme marge toe te passen, waarbij van elke rand evenveel inhoud wordt weggenomen.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/crop-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| margin | number | Nee | `20` | Uniforme bijsnijmarge in punten (0-2000) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/crop-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"margin": 50}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2440000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- De margewaarde is in PDF-punten (1 punt = 1/72 inch).
|
||||
- Dezelfde marge wordt toegepast op alle vier de randen van elke pagina.
|
||||
- Een marge van `0` verwijdert alle bestaande bijsnijmarges en toont de volledige media box.
|
||||
@@ -0,0 +1,47 @@
|
||||
---
|
||||
description: "Haal geselecteerde pagina's uit een PDF in een nieuw document."
|
||||
i18n_source_hash: e4a8fad31e0f
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6481de8aa202
|
||||
---
|
||||
|
||||
# Extract Pages {#extract-pages}
|
||||
|
||||
Haal geselecteerde pagina's uit een PDF in een nieuw, kleiner document.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/extract-pages`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| range | string | Ja | - | Paginabereik in qpdf-syntaxis, bijv. `"1-5,8,10-z"` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/extract-pages \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"range": "1-5,8,10-z"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 3200000,
|
||||
"processedSize": 1100000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Paginabereiken gebruiken qpdf-syntaxis: `1-5` voor pagina's 1 tot en met 5, `z` voor de laatste pagina, en komma's om bereiken te combineren (bijv. `1-3,7,10-z`).
|
||||
- De geëxtraheerde pagina's behouden hun oorspronkelijke opmaak, annotaties en links.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Bak formulieren en annotaties in de pagina-inhoud."
|
||||
i18n_source_hash: b25c2a2b6f40
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 474ae6ea34fa
|
||||
---
|
||||
|
||||
# Flatten PDF {#flatten-pdf}
|
||||
|
||||
Bak interactieve formuliervelden en annotaties in de pagina-inhoud en produceer een statische PDF die er overal hetzelfde uitziet.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/flatten-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen configureerbare parameters. Upload een PDF en alle formulieren en annotaties worden afgevlakt.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/flatten-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@form.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/form.pdf",
|
||||
"originalSize": 185000,
|
||||
"processedSize": 172000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Geaccepteerd invoerformaat: `.pdf`.
|
||||
- Dit is een snel (synchroon) hulpmiddel dat het resultaat direct teruggeeft.
|
||||
- Formulierveldwaarden blijven behouden als statische tekst in de uitvoer.
|
||||
- Annotaties (opmerkingen, markeringen, plaknotities) worden onderdeel van de pagina-inhoud en kunnen niet meer worden bewerkt.
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
description: "Zet alle kleuren in een PDF om naar grijstinten."
|
||||
i18n_source_hash: f327addb32d6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 43d9bcfd65d9
|
||||
---
|
||||
|
||||
# Grayscale PDF {#grayscale-pdf}
|
||||
|
||||
Zet alle kleuren in een PDF om naar grijstinten en produceer een zwart-witversie van het document.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/grayscale-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand. Er is geen veld `settings` vereist.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen instellingsparameters. Upload het PDF-bestand direct.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/grayscale-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 3200000,
|
||||
"processedSize": 2800000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Alle kleurruimten (RGB, CMYK) worden omgezet naar grijstinten, inclusief ingebedde afbeeldingen, vectorafbeeldingen en tekst.
|
||||
- Het uitvoerbestand is vaak kleiner dan het origineel omdat grijstintgegevens minder bytes per pixel vereisen.
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
description: "Lineariseer een PDF voor snelle weergave op het web (progressief downloaden)."
|
||||
i18n_source_hash: 36280b478161
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 1f31a94205e7
|
||||
---
|
||||
|
||||
# Web-Optimize PDF {#web-optimize-pdf}
|
||||
|
||||
Lineariseer een PDF zodat deze progressief kan worden gedownload en weergegeven in webbrowsers zonder op het volledige bestand te wachten.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/linearize-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand. Er is geen veld `settings` vereist.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen instellingsparameters. Upload het PDF-bestand direct.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/linearize-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2460000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Linearisatie herschikt de interne structuur van de PDF zodat de eerste pagina kan worden weergegeven voordat het volledige bestand is gedownload.
|
||||
- Het uitvoerbestand kan iets groter zijn dan de invoer vanwege de toegevoegde linearisatiegegevens.
|
||||
- Reeds gelineariseerde PDF's worden zonder problemen opnieuw gelineariseerd.
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "Combineer meerdere PDF's tot één document."
|
||||
i18n_source_hash: e82e389cb8b6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 948726ac482d
|
||||
---
|
||||
|
||||
# Merge PDFs {#merge-pdfs}
|
||||
|
||||
Combineer twee of meer PDF-bestanden tot één document, met behoud van de paginavolgorde van elk invoerbestand.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/merge-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met twee of meer PDF-bestanden. Er is geen veld `settings` vereist.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen instellingsparameters. Upload gewoon twee of meer PDF-bestanden.
|
||||
|
||||
| Beperking | Waarde |
|
||||
|------------|-------|
|
||||
| Minimum aantal bestanden | 2 |
|
||||
| Maximum aantal bestanden | 20 |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/merge-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document1.pdf" \
|
||||
-F "file=@document2.pdf" \
|
||||
-F "file=@document3.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.pdf",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4200000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Bestanden worden samengevoegd in de volgorde waarin ze worden geüpload.
|
||||
- Er zijn minstens twee PDF-bestanden vereist; het verzoek mislukt met een 400-fout als er minder worden aangeleverd.
|
||||
- Het maximale aantal invoerbestanden is 20.
|
||||
- Versleutelde PDF's moeten worden ontgrendeld voordat ze worden samengevoegd.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Rangschik meerdere PDF-pagina's per vel (2-up, 4-up, enz.)."
|
||||
i18n_source_hash: 9dd82737cb72
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0bc3216f7107
|
||||
---
|
||||
|
||||
# N-up PDF {#n-up-pdf}
|
||||
|
||||
Rangschik meerdere pagina's per vel om papier te besparen bij het afdrukken, zoals 2-up- of 4-up-indelingen.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/nup-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| perSheet | integer | Nee | `2` | Pagina's per vel: `2`, `3`, `4`, `8`, `9`, `12`, of `16` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/nup-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"perSheet": 4}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2300000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Pagina's worden in leesvolgorde gerangschikt (van links naar rechts, van boven naar beneden).
|
||||
- De uitvoerpaginagrootte komt overeen met het origineel; individuele pagina's worden verkleind om in het raster te passen.
|
||||
- Een document van 20 pagina's met `perSheet: 4` produceert een uitvoer van 5 pagina's.
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "Extraheer tekst uit PDF-documenten met AI-gedreven OCR."
|
||||
i18n_source_hash: 1431fcba180b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 940e2e52bf37
|
||||
---
|
||||
|
||||
# PDF OCR {#pdf-ocr}
|
||||
|
||||
Extraheer tekst uit PDF-documenten met AI-gedreven optische tekenherkenning. Ondersteunt meerdere kwaliteitsniveaus en talen. Vereist dat de OCR-functiebundel is geïnstalleerd.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/ocr-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een optioneel JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| quality | string | Nee | `"balanced"` | OCR-kwaliteitsniveau: `fast`, `balanced`, `best` |
|
||||
| language | string | Nee | `"auto"` | Documenttaal: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko` |
|
||||
| pages | string | Nee | `"all"` | Paginaselectie, bijv. `"all"`, `"1-3"`, `"1,3,5"` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/ocr-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@scanned.pdf" \
|
||||
-F 'settings={"quality": "best", "language": "en", "pages": "1-5"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Geeft `202 Accepted` terug. Volg de voortgang via SSE op `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Geaccepteerd invoerformaat: `.pdf`.
|
||||
- Dit is een AI-hulpmiddel dat vereist dat de **OCR-functiebundel** is geïnstalleerd. Als de bundel niet is geïnstalleerd, geeft de API `501 Not Implemented` terug.
|
||||
- Het kwaliteitsniveau `fast` gebruikt een lichter model voor snellere verwerking; `best` gebruikt een nauwkeuriger model ten koste van snelheid.
|
||||
- De taalinstelling `auto` probeert de documenttaal automatisch te detecteren.
|
||||
- Je kunt specifieke pagina's aanwijzen met bereiken (`"1-3"`), door komma's gescheiden lijsten (`"1,3,5"`), of `"all"` voor elke pagina.
|
||||
- Voor PDF's die al selecteerbare tekst bevatten, kun je beter het snellere hulpmiddel [PDF to Text](./pdf-to-text) gebruiken.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Herschik pagina's in een PDF met een expliciete paginavolgorde."
|
||||
i18n_source_hash: e961fc895b4b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 5ce87e338e84
|
||||
---
|
||||
|
||||
# Organize PDF {#organize-pdf}
|
||||
|
||||
Herschik pagina's in een PDF door de gewenste paginavolgorde op te geven.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/organize-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| order | string | Ja | - | Gewenste paginavolgorde in qpdf-syntaxis, bijv. `"3,1,2,5-z"` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/organize-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"order": "3,1,2,5-z"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2450000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Paginabereiken gebruiken qpdf-syntaxis: `3,1,2` herschikt de eerste drie pagina's, en `5-z` voegt pagina's 5 tot en met de laatste pagina toe.
|
||||
- Pagina's kunnen worden gedupliceerd door ze meer dan één keer op te sommen (bijv. `"1,1,2,3"` dupliceert pagina 1).
|
||||
- Pagina's die niet in de volgordestring staan, worden weggelaten uit de uitvoer.
|
||||
@@ -0,0 +1,61 @@
|
||||
---
|
||||
description: "Lees en schrijf PDF-documentmetadata."
|
||||
i18n_source_hash: b2eaebf7467f
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 68b0b9e34a84
|
||||
---
|
||||
|
||||
# PDF Metadata {#pdf-metadata}
|
||||
|
||||
Lees en werk metadatavelden van een PDF-document bij, zoals titel, auteur, onderwerp en trefwoorden. Wanneer er geen instellingen worden opgegeven, wordt de bestaande metadata zonder wijziging teruggegeven.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdf-metadata`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een optioneel JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| title | string | Nee | - | Documenttitel (max. 500 tekens) |
|
||||
| author | string | Nee | - | Documentauteur (max. 500 tekens) |
|
||||
| subject | string | Nee | - | Documentonderwerp (max. 500 tekens) |
|
||||
| keywords | string | Nee | - | Documenttrefwoorden (max. 500 tekens) |
|
||||
|
||||
Alle parameters zijn optioneel. Weggelaten velden blijven ongewijzigd.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-metadata \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.pdf" \
|
||||
-F 'settings={"title": "Q2 Report", "author": "Finance Team"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/report.pdf",
|
||||
"originalSize": 245000,
|
||||
"processedSize": 245200,
|
||||
"metadata": {
|
||||
"title": "Q2 Report",
|
||||
"author": "Finance Team",
|
||||
"subject": "",
|
||||
"keywords": ""
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Geaccepteerd invoerformaat: `.pdf`.
|
||||
- Dit is een snel (synchroon) hulpmiddel dat het resultaat direct teruggeeft.
|
||||
- Het veld `metadata` in het antwoord bevat de resulterende metadata na eventuele updates.
|
||||
- Om metadata te lezen zonder deze te wijzigen, laat je het veld `settings` weg of stuur je een leeg object.
|
||||
- Elk metadataveld is beperkt tot 500 tekens.
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
description: "Voeg paginanummers toe aan elke pagina van een PDF."
|
||||
i18n_source_hash: 58342d6ac8d2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 94b3a252b194
|
||||
---
|
||||
|
||||
# PDF Page Numbers {#pdf-page-numbers}
|
||||
|
||||
Voeg "Pagina N van M"-paginanummers toe aan elke pagina van een PDF.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdf-page-numbers`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| position | string | Nee | `"bc"` | Plaatsing van het paginanummer: `bl`, `bc`, `br`, `tl`, `tc`, `tr` |
|
||||
| fontSize | integer | Nee | `10` | Lettergrootte in punten (6-24) |
|
||||
|
||||
### Position Values {#position-values}
|
||||
|
||||
- `tl` linksboven, `tc` middenboven, `tr` rechtsboven
|
||||
- `bl` linksonder, `bc` middenonder, `br` rechtsonder
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-page-numbers \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"position": "bc", "fontSize": 12}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2470000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Paginanummers worden weergegeven in de indeling "Pagina 1 van 10".
|
||||
- Nummers worden aan elke pagina toegevoegd, inclusief eventuele bestaande titel- of omslagpagina's.
|
||||
- De standaardpositie `"bc"` plaatst nummers middenonder op elke pagina.
|
||||
@@ -0,0 +1,133 @@
|
||||
---
|
||||
description: "Converteer PDF-pagina's naar hoogwaardige afbeeldingen."
|
||||
i18n_source_hash: 1c36be5dadb8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b50664331b9b
|
||||
---
|
||||
|
||||
# PDF to Image {#pdf-to-image}
|
||||
|
||||
Converteer PDF-pagina's naar hoogwaardige rasterafbeeldingen. Ondersteunt paginaselectie, meerdere uitvoerformaten, DPI-instelling en kleurmodi. Bevat info- en preview-subroutes om PDF's te inspecteren vóór conversie.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdf-to-image`
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Nee | `"png"` | Uitvoerformaat: `png`, `jpg`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl` |
|
||||
| dpi | number | Nee | 150 | Renderresolutie (36 tot 2400). Een hogere DPI produceert grotere, gedetailleerdere afbeeldingen. |
|
||||
| quality | number | Nee | 85 | Uitvoerkwaliteit voor verliesgevende formaten (1 tot 100) |
|
||||
| colorMode | string | Nee | `"color"` | Kleurmodus: `color`, `grayscale`, `bw` (zwart-witdrempel) |
|
||||
| pages | string | Nee | `"all"` | Paginaselectie: `all`, enkele pagina (`3`), bereik (`1-5`), of door komma's gescheiden (`1,3,5-8`) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-to-image \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"format":"png","dpi":300,"pages":"1-3","colorMode":"color"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"pageCount": 10,
|
||||
"selectedPages": [1, 2, 3],
|
||||
"format": "png",
|
||||
"pages": [
|
||||
{
|
||||
"page": 1,
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/page-1.png",
|
||||
"size": 234567
|
||||
},
|
||||
{
|
||||
"page": 2,
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/page-2.png",
|
||||
"size": 198765
|
||||
},
|
||||
{
|
||||
"page": 3,
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/page-3.png",
|
||||
"size": 210456
|
||||
}
|
||||
],
|
||||
"zipUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/pdf-pages.zip",
|
||||
"zipSize": 612345
|
||||
}
|
||||
```
|
||||
|
||||
## Info Sub-Route {#info-sub-route}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdf-to-image/info`
|
||||
|
||||
Geeft het aantal pagina's van een PDF terug zonder pagina's te renderen.
|
||||
|
||||
### Info Request {#info-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-to-image/info \
|
||||
-F "file=@document.pdf"
|
||||
```
|
||||
|
||||
### Info Response {#info-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"pageCount": 10
|
||||
}
|
||||
```
|
||||
|
||||
## Preview Sub-Route {#preview-sub-route}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdf-to-image/preview`
|
||||
|
||||
Geeft JPEG-miniaturen met lage resolutie van alle pagina's terug als base64-data-URL's. Handig voor het bouwen van een paginaselectie-UI.
|
||||
|
||||
### Preview Request {#preview-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-to-image/preview \
|
||||
-F "file=@document.pdf"
|
||||
```
|
||||
|
||||
### Preview Response {#preview-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"pageCount": 10,
|
||||
"thumbnails": [
|
||||
{
|
||||
"page": 1,
|
||||
"dataUrl": "data:image/jpeg;base64,/9j/4AAQ...",
|
||||
"width": 300,
|
||||
"height": 424
|
||||
},
|
||||
{
|
||||
"page": 2,
|
||||
"dataUrl": "data:image/jpeg;base64,/9j/4AAQ...",
|
||||
"width": 300,
|
||||
"height": 424
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Gebruikt MuPDF voor PDF-rendering, wat hoogwaardige uitvoer levert met correcte lettertypeweergave en vectorafbeeldingen.
|
||||
- Met een wachtwoord beveiligde PDF's worden niet ondersteund en geven een 400-fout terug.
|
||||
- De parameter `pages` ondersteunt flexibele syntaxis:
|
||||
- `"all"` of `""` - alle pagina's
|
||||
- `"3"` - enkele pagina
|
||||
- `"1-5"` - paginabereik (inclusief)
|
||||
- `"1,3,5-8"` - gemengde individuele pagina's en bereiken
|
||||
- Paginanummers zijn 1-gebaseerd. Pagina's opgeven buiten de documentlengte geeft een 400-fout terug.
|
||||
- Het hoofdendpoint genereert altijd zowel individuele pagina-downloads als een ZIP met alle geselecteerde pagina's.
|
||||
- Het preview-endpoint rendert op 72 DPI en schaalt naar 300px breedte voor snelle miniatuurgeneratie. Miniaturen zijn JPEG met 60% kwaliteit.
|
||||
- Het preview-endpoint respecteert de serverconfiguratie `MAX_PDF_PAGES`, die beperkt hoeveel miniaturen worden gegenereerd.
|
||||
- Voor grote documenten met een hoge DPI neemt de verwerkingstijd evenredig toe. Overweeg een lagere DPI (150) voor webgebruik en een hogere DPI (300-600) voor afdrukken.
|
||||
@@ -0,0 +1,47 @@
|
||||
---
|
||||
description: "Extraheer platte tekst uit een PDF."
|
||||
i18n_source_hash: 15a7bc1cdf8f
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ffbc8e1471fd
|
||||
---
|
||||
|
||||
# PDF to Text {#pdf-to-text}
|
||||
|
||||
Extraheer alle leesbare platte tekst uit een PDF-document naar een tekstbestand.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdf-to-text`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen configureerbare parameters. Upload een PDF en de tekstinhoud wordt geëxtraheerd.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-to-text \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/report.txt",
|
||||
"originalSize": 520000,
|
||||
"processedSize": 14300,
|
||||
"chars": 14300
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Geaccepteerd invoerformaat: `.pdf`.
|
||||
- Dit is een snel (synchroon) hulpmiddel dat het resultaat direct teruggeeft.
|
||||
- Het veld `chars` in het antwoord geeft het aantal geëxtraheerde tekens aan.
|
||||
- Alleen digitaal ingebedde tekst wordt geëxtraheerd. Gebruik voor gescande documenten of op afbeeldingen gebaseerde PDF's het hulpmiddel [PDF OCR](./ocr-pdf).
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converteer een PDF naar een Word-document (DOCX)."
|
||||
i18n_source_hash: be41b6b49f84
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 274535771718
|
||||
---
|
||||
|
||||
# PDF to Word {#pdf-to-word}
|
||||
|
||||
Converteer een op tekst gebaseerde PDF naar een Word-document (DOCX). Het meest geschikt voor PDF's met selecteerbare tekst; gescande pagina's hebben eerst OCR nodig.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdf-to-word`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen configureerbare parameters. Upload een PDF en deze wordt geconverteerd naar DOCX.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-to-word \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Geeft `202 Accepted` terug. Volg de voortgang via SSE op `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Geaccepteerd invoerformaat: `.pdf`.
|
||||
- Werkt het best met op tekst gebaseerde PDF's. Gescande of alleen-afbeeldingspagina's produceren lege of minimale uitvoer; gebruik [PDF OCR](./ocr-pdf) om eerst een tekstlaag toe te voegen.
|
||||
- De conversie wordt uitgevoerd door LibreOffice dat headless op de server draait.
|
||||
- Complexe indelingen (meerdere kolommen, overlappende elementen) worden mogelijk niet perfect geconverteerd.
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
description: "Converteer een PDF naar het archief-PDF/A-2-formaat voor langdurige bewaring."
|
||||
i18n_source_hash: 4c6bf7a12e84
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 75010fc5a155
|
||||
---
|
||||
|
||||
# PDF/A Convert {#pdf-a-convert}
|
||||
|
||||
Converteer een PDF naar het PDF/A-2-archiefformaat, geschikt voor langdurige bewaring en naleving van regelgeving.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/pdfa-convert`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand. Er is geen veld `settings` vereist.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen instellingsparameters. Upload het PDF-bestand direct.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdfa-convert \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2600000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- De uitvoer voldoet aan de PDF/A-2-standaard.
|
||||
- PDF/A bedt alle lettertypen in en staat geen externe verwijzingen toe, dus het uitvoerbestand kan groter zijn dan het origineel.
|
||||
- Versleuteling en JavaScript worden tijdens de conversie verwijderd, aangezien ze niet zijn toegestaan door de PDF/A-standaard.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Voeg wachtwoordbeveiliging met AES-256-versleuteling toe aan een PDF."
|
||||
i18n_source_hash: 869cfbc739ef
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6143236a87da
|
||||
---
|
||||
|
||||
# Protect PDF {#protect-pdf}
|
||||
|
||||
Voeg wachtwoordbeveiliging toe aan een PDF met AES-256-versleuteling.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/protect-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| userPassword | string | Ja | - | Wachtwoord dat vereist is om de PDF te openen (1-256 tekens) |
|
||||
| ownerPassword | string | Nee | Hetzelfde als `userPassword` | Eigenaarswachtwoord voor rechten (1-256 tekens) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/protect-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"userPassword": "s3cret", "ownerPassword": "0wn3r"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Versleuteling gebruikt AES-256.
|
||||
- Als `ownerPassword` wordt weggelaten, krijgt het standaard dezelfde waarde als `userPassword`.
|
||||
- Wachtwoorden worden geredigeerd uit auditlogs.
|
||||
- De versleutelde PDF vereist het gebruikerswachtwoord om te openen en het eigenaarswachtwoord (indien verschillend) voor volledige rechten.
|
||||
@@ -0,0 +1,52 @@
|
||||
---
|
||||
description: "Verwijder tekstvoorkomens permanent uit een PDF (geverifieerde echte redactie)."
|
||||
i18n_source_hash: 296ad2a701b2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 361b7eb14f09
|
||||
---
|
||||
|
||||
# Redact PDF {#redact-pdf}
|
||||
|
||||
Verwijder opgegeven tekstvoorkomens permanent uit een PDF met geverifieerde echte redactie. De geredigeerde tekst wordt volledig uit het bestand verwijderd, niet alleen afgedekt met een zwart vlak.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/redact-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| terms | string[] | Ja | - | Te redigeren tekststrings (1-50 termen, elk tot 200 tekens) |
|
||||
| caseSensitive | boolean | Nee | `false` | Of matching hoofdlettergevoelig is |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/redact-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@contract.pdf" \
|
||||
-F 'settings={"terms": ["John Doe", "555-0123"], "caseSensitive": false}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/contract.pdf",
|
||||
"originalSize": 245000,
|
||||
"processedSize": 243000,
|
||||
"found": 7
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Geaccepteerd invoerformaat: `.pdf`.
|
||||
- Dit is een snel (synchroon) hulpmiddel dat het resultaat direct teruggeeft.
|
||||
- Dit voert echte redactie uit: overeenkomende tekst wordt uit de PDF-inhoudsstroom verwijderd, niet alleen visueel verhuld.
|
||||
- Het veld `found` in het antwoord geeft aan hoeveel voorkomens zijn geredigeerd.
|
||||
- Je kunt tot 50 termen in één verzoek redigeren.
|
||||
@@ -0,0 +1,47 @@
|
||||
---
|
||||
description: "Verwijder specifieke pagina's uit een PDF."
|
||||
i18n_source_hash: 003e460a047c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 93e5d4704f38
|
||||
---
|
||||
|
||||
# Remove Pages {#remove-pages}
|
||||
|
||||
Verwijder specifieke pagina's uit een PDF, waarbij alle overige pagina's intact blijven.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/remove-pages`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pages | string | Ja | - | Te verwijderen paginabereik in qpdf-syntaxis, bijv. `"3,5-7"` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/remove-pages \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"pages": "3,5-7"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 1800000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Je kunt niet elke pagina uit een document verwijderen; er moet minstens één pagina overblijven.
|
||||
- Paginabereiken gebruiken qpdf-syntaxis: `3` voor een enkele pagina, `5-7` voor een bereik, en komma's om te combineren (bijv. `1,3,5-7`).
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
description: "Probeer een beschadigde of corrupte PDF te repareren."
|
||||
i18n_source_hash: 864073a2f09f
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 085995aa0a81
|
||||
---
|
||||
|
||||
# Repair PDF {#repair-pdf}
|
||||
|
||||
Probeer een beschadigde of corrupte PDF te repareren door de interne structuur ervan te reconstrueren.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/repair-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand. Er is geen veld `settings` vereist.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dit hulpmiddel heeft geen instellingsparameters. Upload het beschadigde PDF-bestand direct.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/repair-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@damaged.pdf"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/damaged.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2400000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Structurele validatie wordt bij invoer overgeslagen om misvormde bestanden door te laten.
|
||||
- Reparatie is een best-effort; ernstig corrupte bestanden zijn mogelijk niet volledig te herstellen.
|
||||
- De gerepareerde PDF kan qua grootte iets afwijken van het origineel vanwege gereconstrueerde kruisverwijzingstabellen.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Roteer pagina's in een PDF met 90, 180 of 270 graden."
|
||||
i18n_source_hash: cc2acd091427
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0f2de7830082
|
||||
---
|
||||
|
||||
# Rotate PDF {#rotate-pdf}
|
||||
|
||||
Roteer alle of geselecteerde pagina's in een PDF met een opgegeven hoek.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/rotate-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| angle | integer | Nee | `90` | Rotatiehoek: `90`, `180`, of `270` |
|
||||
| range | string | Nee | `"1-z"` | Paginabereik in qpdf-syntaxis, bijv. `"1-5,8"` (`"1-z"` = alle pagina's) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/rotate-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"angle": 90, "range": "1-3"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2450000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Rotatie is met de klok mee.
|
||||
- Paginabereiken gebruiken qpdf-syntaxis: `1-5` voor pagina's 1 tot en met 5, `z` voor de laatste pagina, en komma's om bereiken te combineren.
|
||||
- Het standaardbereik `"1-z"` roteert alle pagina's.
|
||||
@@ -0,0 +1,79 @@
|
||||
---
|
||||
description: "Stempel geüploade handtekeningafbeeldingen op een PDF met genormaliseerde paginaplaatsingen."
|
||||
i18n_source_hash: c28f78c2e7fd
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: fe5d034c05b2
|
||||
---
|
||||
|
||||
# Sign PDF {#sign-pdf}
|
||||
|
||||
Stempel een of meer geüploade handtekening-PNG-afbeeldingen op een willekeurige pagina van een PDF. Deze route gebruikt een aangepast multipart-contract omdat het de PDF, een of meer handtekeningafbeeldingen en plaatsingscoördinaten nodig heeft.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/sign-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens. De PDF wordt verzonden als `file`; handtekeningen worden verzonden als `sig0`, `sig1`, enzovoort; plaatsingen worden verzonden in een JSON-veld `placements`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| file | file | Ja | - | Te ondertekenen PDF-bestand |
|
||||
| sig0 | file | Ja | - | Eerste handtekeningafbeelding. Extra afbeeldingen gebruiken `sig1`, `sig2`, enzovoort |
|
||||
| placements | JSON string | Ja | - | Array van plaatsingsobjecten: `{ "sig": 0, "page": 0, "x": 0.2, "y": 0.7, "w": 0.25, "h": 0.08 }` |
|
||||
| clientJobId | string | Nee | - | Optionele UUID voor voortgangstracering via SSE |
|
||||
| fileId | string | Nee | - | Optionele bestandsbibliotheek-ID om het ondertekende resultaat als een nieuwe versie op te slaan |
|
||||
|
||||
## Placement Coordinates {#placement-coordinates}
|
||||
|
||||
| Veld | Type | Beschrijving |
|
||||
|-------|------|-------------|
|
||||
| sig | integer | Index van de handtekeningafbeelding. `0` verwijst naar `sig0` |
|
||||
| page | integer | Nulgebaseerde PDF-pagina-index |
|
||||
| x | number | Linkerpositie als paginafractie |
|
||||
| y | number | Bovenpositie als paginafractie |
|
||||
| w | number | Handtekeningbreedte als paginafractie |
|
||||
| h | number | Handtekeninghoogte als paginafractie |
|
||||
|
||||
Coördinaten gebruiken een oorsprong linksboven. Waarden mogen iets buiten de paginarand uitlopen; de PDF-renderer knipt de uiteindelijke stempel bij op de pagina.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/sign-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@contract.pdf" \
|
||||
-F "sig0=@signature.png" \
|
||||
-F 'placements=[{"sig":0,"page":0,"x":0.64,"y":0.82,"w":0.22,"h":0.08}]'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/contract_signed.pdf",
|
||||
"previewUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/preview.png",
|
||||
"originalSize": 245000,
|
||||
"processedSize": 249000
|
||||
}
|
||||
```
|
||||
|
||||
Als het verzoek niet binnen het synchrone wachtvenster kan worden afgerond, geeft de API het volgende terug:
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
Maak verbinding met `/api/v1/jobs/<jobId>/progress` en download het resultaat wanneer de taak is voltooid.
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Geaccepteerd PDF-invoerformaat: `.pdf`.
|
||||
- Handtekeningafbeeldingen moeten geldige afbeeldingsbestanden zijn, doorgaans PNG met transparantie.
|
||||
- Er worden tot 100 handtekeningafbeeldingen en 100 plaatsingen geaccepteerd.
|
||||
- `sign-pdf` is een aangepaste route en gebruikt niet het standaard JSON-veld `settings` van het hulpmiddel.
|
||||
@@ -0,0 +1,61 @@
|
||||
---
|
||||
description: "Extraheer pagina's of splits een PDF in delen."
|
||||
i18n_source_hash: 5c8d8041d219
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ed6456076bd6
|
||||
---
|
||||
|
||||
# Split PDF {#split-pdf}
|
||||
|
||||
Extraheer een reeks pagina's naar een nieuwe PDF, of splits een document in stukken van N pagina's.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/split-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | Nee | `"range"` | Splitsmodus: `range` of `every` |
|
||||
| range | string | Wanneer mode `range` is | - | Paginabereik in qpdf-syntaxis, bijv. `"1-5,8,10-z"` |
|
||||
| everyN | integer | Wanneer mode `every` is | - | Splitsen in stukken van N pagina's (1-500) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
Specifieke pagina's extraheren:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/split-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"mode": "range", "range": "1-5,8"}'
|
||||
```
|
||||
|
||||
Splitsen in stukken van 10 pagina's:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/split-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"mode": "every", "everyN": 10}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 980000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- In de modus `range` wordt een enkele PDF met de geselecteerde pagina's teruggegeven.
|
||||
- In de modus `every` is het resultaat een ZIP-archief met de afzonderlijke delen.
|
||||
- Paginabereiken gebruiken qpdf-syntaxis: `1-5` voor pagina's 1 tot en met 5, `z` voor de laatste pagina, en komma's om bereiken te combineren (bijv. `1-3,7,10-z`).
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Verwijder wachtwoordbeveiliging van een PDF."
|
||||
i18n_source_hash: 14f5165d185c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9a9b8271d46b
|
||||
---
|
||||
|
||||
# Unlock PDF {#unlock-pdf}
|
||||
|
||||
Verwijder wachtwoordbeveiliging van een versleutelde PDF door het juiste wachtwoord op te geven.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/unlock-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| password | string | Ja | - | Wachtwoord om de PDF te ontsleutelen (1-256 tekens) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/unlock-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"password": "s3cret"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2500000,
|
||||
"processedSize": 2450000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Het juiste wachtwoord moet worden opgegeven; een onjuist wachtwoord geeft een 400-fout terug.
|
||||
- Zowel het gebruikerswachtwoord als het eigenaarswachtwoord werkt voor ontsleuteling.
|
||||
- Wachtwoorden worden geredigeerd uit auditlogs.
|
||||
@@ -0,0 +1,58 @@
|
||||
---
|
||||
description: "Voeg een tekstwatermerk toe aan elke pagina van een PDF."
|
||||
i18n_source_hash: f1f7d8912fbd
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6376fffd7b48
|
||||
---
|
||||
|
||||
# Watermark PDF {#watermark-pdf}
|
||||
|
||||
Stempel een tekstwatermerk op elke pagina van een PDF met configureerbare positie, grootte, dekking en rotatie.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/pdf/watermark-pdf`
|
||||
|
||||
Accepteert multipart-formuliergegevens met een PDF-bestand en een JSON-veld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| text | string | Ja | - | Watermerktekst (1-200 tekens) |
|
||||
| position | string | Nee | `"c"` | Plaatsing op de pagina: `tl`, `tc`, `tr`, `l`, `c`, `r`, `bl`, `bc`, `br` |
|
||||
| fontSize | integer | Nee | `48` | Lettergrootte in punten (6-72) |
|
||||
| opacity | number | Nee | `0.3` | Watermerkdekking (0.05-1) |
|
||||
| rotation | number | Nee | `45` | Rotatiehoek in graden (-180 tot 180) |
|
||||
|
||||
### Position Values {#position-values}
|
||||
|
||||
- `tl` linksboven, `tc` middenboven, `tr` rechtsboven
|
||||
- `l` midden-links, `c` midden, `r` midden-rechts
|
||||
- `bl` linksonder, `bc` middenonder, `br` rechtsonder
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/pdf/watermark-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.pdf" \
|
||||
-F 'settings={"text": "CONFIDENTIAL", "position": "c", "opacity": 0.2, "rotation": 45}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
|
||||
"originalSize": 2450000,
|
||||
"processedSize": 2500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Het watermerk wordt weergegeven als een tekstoverlay op elke pagina.
|
||||
- Dezelfde watermerktekst, positie en stijl worden uniform op alle pagina's toegepast.
|
||||
- Gebruik lagere dekkingswaarden (0.1-0.3) voor subtiele watermerken die de inhoud niet verhullen.
|
||||
Reference in New Issue
Block a user