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

3.2 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Nanieś przesłane obrazy podpisów na plik PDF, używając znormalizowanych rozmieszczeń na stronie.	c28f78c2e7fd	human	3bb0e466cf77

Sign PDF

Nanieś jeden lub więcej przesłanych obrazów podpisów PNG na dowolną stronę pliku PDF. Ta trasa używa niestandardowego kontraktu multipart, ponieważ potrzebuje pliku PDF, jednego lub więcej obrazów podpisów oraz współrzędnych rozmieszczenia.

API Endpoint

POST /api/v1/tools/pdf/sign-pdf

Przyjmuje dane formularza multipart. Plik PDF jest wysyłany jako file; podpisy są wysyłane jako sig0, sig1 i tak dalej; rozmieszczenia są wysyłane w polu JSON placements.

Parameters

Parameter	Type	Required	Default	Description
file	file	Yes	-	Plik PDF do podpisania
sig0	file	Yes	-	Pierwszy obraz podpisu. Dodatkowe obrazy używają `sig1`, `sig2` i tak dalej
placements	JSON string	Yes	-	Tablica obiektów rozmieszczenia: `{ "sig": 0, "page": 0, "x": 0.2, "y": 0.7, "w": 0.25, "h": 0.08 }`
clientJobId	string	No	-	Opcjonalny UUID do śledzenia postępu przez SSE
fileId	string	No	-	Opcjonalny identyfikator biblioteki plików do zapisania podpisanego wyniku jako nowej wersji

Placement Coordinates

Field	Type	Description
sig	integer	Indeks obrazu podpisu. `0` odpowiada `sig0`
page	integer	Indeks strony PDF liczony od zera
x	number	Pozycja lewej krawędzi jako ułamek strony
y	number	Pozycja górnej krawędzi jako ułamek strony
w	number	Szerokość podpisu jako ułamek strony
h	number	Wysokość podpisu jako ułamek strony

Współrzędne używają początku w lewym górnym rogu. Wartości mogą nieznacznie wykraczać poza krawędź strony; renderer PDF przycina finalny stempel do strony.

Example Request

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

{
  "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
}

Jeśli żądanie nie może zakończyć się w oknie oczekiwania synchronicznego, API zwraca:

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Połącz się z /api/v1/jobs/<jobId>/progress i pobierz wynik, gdy zadanie się zakończy.

Notes

Akceptowany format wejściowy PDF: .pdf.
Obrazy podpisów muszą być prawidłowymi plikami graficznymi, zwykle PNG z przezroczystością.
Akceptowane jest do 100 obrazów podpisów i 100 rozmieszczeń.
sign-pdf to niestandardowa trasa i nie używa standardowego pola JSON settings narzędzia.

3.2 KiB Raw Blame History