mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd 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.

2026-07-11 13:52:47 +08:00

4.0 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Combineer een of meer afbeeldingen tot een PDF-document met opties voor paginagrootte, oriëntatie en doelbestandsgrootte.	f659c7e7f56b	human	fdf3d681ccbe

Afbeelding naar PDF

Combineer een of meer afbeeldingen tot een PDF-document. Ondersteunt meerdere paginagroottes, oriëntaties, marges en optionele doelbestandsgrootte via kwaliteitsaanpassing.

API Endpoint

POST /api/v1/tools/image/image-to-pdf

Accepteert multipart-formuliergegevens met een of meer afbeeldingsbestanden en een JSON-veld settings.

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
pageSize	string	Nee	`"A4"`	Paginagrootte: `A4`, `Letter`, `A3`, `A5`
orientation	string	Nee	`"portrait"`	Pagina-oriëntatie: `portrait` of `landscape`
margin	number	Nee	`20`	Paginamarge in punten (0-500)
targetSize	object	Nee	-	Beperking van de doelbestandsgrootte (zie hieronder)
collate	boolean	Nee	`true`	Combineer alle afbeeldingen tot één PDF. Indien `false`, maak één PDF per afbeelding.

Target Size-object

Veld	Type	Vereist	Beschrijving
value	number	Ja	Waarde van de doelgrootte
unit	string	Ja	Eenheid: `KB` of `MB`

De minimale doelgrootte is 50 KB.

Voorbeeldverzoek

Basis-PDF met meerdere afbeeldingen:

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@page1.jpg" \
  -F "file=@page2.jpg" \
  -F "file=@page3.jpg" \
  -F 'settings={"pageSize": "A4", "orientation": "portrait", "margin": 20}'

Met doelbestandsgrootte:

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@scan1.jpg" \
  -F "file=@scan2.jpg" \
  -F 'settings={"pageSize": "Letter", "targetSize": {"value": 2, "unit": "MB"}}'

Eén PDF per afbeelding:

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo1.jpg" \
  -F "file=@photo2.jpg" \
  -F 'settings={"collate": false}'

Voorbeeldantwoord (gecollationeerd)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/images.pdf",
  "originalSize": 5000000,
  "processedSize": 1200000,
  "pages": 3
}

Voorbeeldantwoord (niet-gecollationeerd)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/images.zip",
  "originalSize": 5000000,
  "processedSize": 2400000,
  "pages": 2,
  "collated": false
}

Voorbeeldantwoord (met doelgrootte)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/images.pdf",
  "originalSize": 10000000,
  "processedSize": 2000000,
  "pages": 5,
  "compression": {
    "targetRequested": 2097152,
    "targetMet": true,
    "jpegQuality": 72
  }
}

Opmerkingen

Afbeeldingen worden op de pagina gecentreerd en geschaald om binnen de marges te passen met behoud van de beeldverhouding. Afbeeldingen worden nooit vergroot.
Wanneer collate false is, wordt elke afbeelding een afzonderlijk PDF-bestand, en de download is een ZIP-archief met alle PDF's.
De functie voor doelgrootte gebruikt iteratief binair zoeken over JPEG-kwaliteitsniveaus (10-95) om de beste kwaliteit te vinden die binnen het budget past.
Transparante afbeeldingen worden samengevoegd op wit voordat ze in de PDF worden ingebed.
Ondersteunde invoerformaten: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW, PSD, SVG en meer.
EXIF-oriëntatie wordt automatisch toegepast vóór het inbedden.

4.0 KiB Raw Blame History