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.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Cap gambar tanda tangan yang diunggah ke PDF menggunakan penempatan halaman yang dinormalisasi.	c28f78c2e7fd	human	80406594e43c

Sign PDF

Cap satu atau lebih gambar PNG tanda tangan yang diunggah ke halaman mana pun dalam PDF. Rute ini menggunakan kontrak multipart khusus karena membutuhkan PDF, satu atau lebih gambar tanda tangan, dan koordinat penempatan.

API Endpoint

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

Menerima data form multipart. PDF dikirim sebagai file; tanda tangan dikirim sebagai sig0, sig1, dan seterusnya; penempatan dikirim dalam field JSON placements.

Parameters

Parameter	Type	Required	Default	Description
file	file	Yes	-	File PDF yang akan ditandatangani
sig0	file	Yes	-	Gambar tanda tangan pertama. Gambar tambahan menggunakan `sig1`, `sig2`, dan seterusnya
placements	JSON string	Yes	-	Array objek penempatan: `{ "sig": 0, "page": 0, "x": 0.2, "y": 0.7, "w": 0.25, "h": 0.08 }`
clientJobId	string	No	-	UUID opsional untuk pelacakan progres melalui SSE
fileId	string	No	-	ID pustaka file opsional untuk menyimpan hasil yang ditandatangani sebagai versi baru

Placement Coordinates

Field	Type	Description
sig	integer	Indeks gambar tanda tangan. `0` dipetakan ke `sig0`
page	integer	Indeks halaman PDF berbasis nol
x	number	Posisi kiri sebagai fraksi halaman
y	number	Posisi atas sebagai fraksi halaman
w	number	Lebar tanda tangan sebagai fraksi halaman
h	number	Tinggi tanda tangan sebagai fraksi halaman

Koordinat menggunakan titik asal kiri-atas. Nilai mungkin sedikit melampaui tepi halaman; perender PDF memotong cap akhir agar sesuai halaman.

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
}

Jika permintaan tidak dapat selesai dalam jendela tunggu sinkron, API mengembalikan:

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

Sambungkan ke /api/v1/jobs/<jobId>/progress dan unduh hasilnya saat job selesai.

Notes

Format input PDF yang diterima: .pdf.
Gambar tanda tangan harus berupa file gambar yang valid, biasanya PNG dengan transparansi.
Hingga 100 gambar tanda tangan dan 100 penempatan diterima.
sign-pdf adalah rute khusus dan tidak menggunakan field JSON settings alat standar.

3.1 KiB Raw Blame History