PDF-Signaturfeld hinzufügen
Ein Feld mit 200 mal 50 Punkt bei 72, 72 auf einer Letter-Seite mit 612 mal 792 passt, mit 340 Punkt Platz rechts und 670 darüber, im Quadranten unten links. Prüfen Sie die Lage der Signatur, bevor sie gestempelt wird. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Seitenbreite
- 612
- Seitenhöhe
- 792
- X
- 72
- Y
- 72
- Breite
- 200
- Höhe
- 50
- Koordinatensystem
- pdf_points_origin_bottom_left
- Quadrant
- bottom_left
- Fläche (Punkte)
- 10.000
- Deckungsgrad in Prozent
- 2,063115
Liegt eine Kante außerhalb der Seite, wird die Platzierung mit einer präzisen Erklärung abgelehnt, welche Grenze überschritten wurde — bevor Sie eine Signaturoperation auf ein Feld verschwenden, das niemand je sehen wird.
Warum die Platzierung von Signaturfeldern in der Produktion scheitert
Und jedes Team, das das Signieren von Dokumenten automatisiert, liefert irgendwann einen Layout-Fehler aus — eine Vertragsvorlage bricht um, eine gescannte Seite kommt in A4 statt Letter an, eine für eine Hochformat-Seite berechnete Koordinate landet auf einer Querformat-Seite, und das Signaturfeld landet außerhalb der sichtbaren Seite. In manchen Werkzeugen wird die Signatur trotzdem angewendet, sodass das Dokument im Dashboard als signiert erscheint, auf der Seite, die ein Mensch öffnet, aber nichts zeigt. Ein Validierungsaufruf ersetzt den nachgelagerten Vorfall.
Koordinaten, Einheiten und was Sie zurückbekommen
Alle Werte sind PDF-Punkte — zweiundsiebzig pro Zoll — mit dem Ursprung in der linken unteren Seitenecke, x wächst nach rechts und y nach oben, genau das Koordinatensystem, das PDF-Signaturfeld-Annotationen nativ verwenden. Im Erfolgsfall gibt die Antwort das normalisierte Rechteck zurück, nennt die vier absoluten Grenzen, den verbleibenden Rand auf jeder Seite, den Mittelpunkt, einen lesbaren Quadranten wie bottom-left, die Feldfläche in Quadratpunkten und den Prozentsatz der Seite, den es abdeckt, dazu eine einzeilige Beschreibung, die Sie direkt in ein Log oder einen Audit-Trail übernehmen können.
Im Fehlerfall trägt die Fehlermeldung die beanstandeten Zahlen: welche Koordinate unter null fiel oder welche berechnete Kante welche Seitendimension überschritt. Die Arithmetik ist reine Rechteckgeometrie mit Werten, die auf sechs Dezimalstellen gerundet sind, sodass dieselbe Anfrage auf jeder Maschine immer eine byte-identische Ausgabe erzeugt.
Wo es in eine Signatur-Pipeline passt
Setzen Sie es als Gate vor jede Operation ein, die ein Signaturfeld schreibt: Vorlagen-Builder validieren jedes Feld beim Speichern der Vorlage, Batch-Signaturjobs validieren dokumentweise unmittelbar vor dem Stempeln, und Ingestion-Pipelines validieren, wenn ein Seitengrößen-Konflikt zwischen Vorlage und eingehender Datei vermutet wird. Da die Fähigkeit reine Geometrie ohne Datei-I/O ist, ist sie schnell genug, um ohne Zögern auf jedem Dokument eines Batches zu laufen, und deterministisch genug, dass ihre Ausgabe als Nachweis einer geprüften Platzierung gespeichert werden kann.
Anwendungsfälle
Eine Signaturvorlage vor der Veröffentlichung validieren
Validieren Sie jedes Signaturfeld einer Vorlage beim Speichern gegen die Zielseitengröße, sodass ein falsch platziertes Feld vom Autor entdeckt wird, nicht vom ersten Unterzeichner.
Einen Batch-Signaturjob absichern
Prüfen Sie die Platzierung pro Dokument unmittelbar vor dem Stempeln; ein Job, der das Feld außerhalb der Seite platzieren würde, schlägt bei diesem Dokument laut fehl, statt still eine unsichtbare Signatur zu versenden.
Eine von einem Kunden gemeldete fehlende Signatur debuggen
Spielen Sie die exakte Seitengröße und das Rechteck aus dem Support-Ticket nach und sehen Sie sofort, welche Seitenkante das Feld überschritten hat — mit den Zahlen, die es beweisen.
Häufige Fragen
Was kostet das?
Kostenlos läuft es auch in Ihrem Browser auf dieser Seite.
Verändert es mein PDF?
Nein. Es validiert nur Geometrie — Sie senden sechs Zahlen, keine Datei. Nichts wird hochgeladen, gespeichert oder geschrieben.
Welches Koordinatensystem wird verwendet?
Native PDF-Punkte: 72 Punkte pro Zoll, Ursprung in der linken unteren Seitenecke, x nach rechts und y nach oben — dasselbe System wie bei Signaturfeld-Annotationen.
Gilt ein Feld genau am Seitenrand als gültig?
Ja. Ein Feld, dessen rechte Kante der Seitenbreite entspricht, liegt vollständig innerhalb; abgelehnt werden nur Kanten strikt jenseits der Seitengrenzen.
Ist das Ergebnis deterministisch?
Ja. Es ist reine Rechteckarithmetik mit Rundung auf sechs Dezimalstellen, sodass dieselbe Eingabe immer eine byte-identische Ausgabe liefert.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/pdf/digital-sign-field \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"page_width":612,"page_height":792,"x":72,"y":72,"width":200,"height":50}'const res = await fetch("https://api.kit.forhosting.com/pdf/digital-sign-field", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"page_width": 612,
"page_height": 792,
"x": 72,
"y": 72,
"width": 200,
"height": 50
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/digital-sign-field",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"page_width": 612,
"page_height": 792,
"x": 72,
"y": 72,
"width": 200,
"height": 50
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/digital-sign-field", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"page_width":612,"page_height":792,"x":72,"y":72,"width":200,"height":50}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"page_width":612,"page_height":792,"x":72,"y":72,"width":200,"height":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/digital-sign-field", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"page_width": 612,
"page_height": 792,
"x": 72,
"y": 72,
"width": 200,
"height": 50
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.digital_sign_field",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_mb | 25 |
max_pages | 200 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Die API zum Hinzufügen eines Signaturfelds zu einem PDF prüft das eine, was Signatur-Workflows still zum Scheitern bringt: ob das Rechteck, das Sie für ein digitales Signaturfeld verwenden wollen, tatsächlich auf die Seite passt. Sie senden die Seitengröße und die Feldposition in PDF-Punkten; die API bestätigt, dass das Feld vollständig innerhalb der Seitengrenzen liegt, und beschreibt die Platzierung — Ränder auf jeder Seite, der Quadrant, in dem sein Mittelpunkt liegt, und wie viel der Seite es abdeckt.
Warum die Platzierung von Signaturfeldern in der Produktion scheitert
Der Endpoint add pdf signature field existiert, um diese Fehlerklasse in dem einzigen Moment abzufangen, in dem sie billig ist: bevor das Feld erstellt wird. Sie beschreiben Seite und Rechteck, und die API bestätigt die Platzierung mit einer vollständigen geometrischen Beschreibung oder lehnt sie ab und nennt die exakt überschrittene Kante — links, unten, jenseits der rechten Kante oder jenseits der oberen.
Koordinaten, Einheiten und was die API zurückgibt
Sie übergeben Seitenbreite und -höhe plus das Feldrechteck als x, y, width und height.
Wo es in eine Signatur-Pipeline passt
Derselbe Code, der die API beantwortet, läuft kostenlos in Ihrem Browser auf dieser Seite, sodass ein Support-Ingenieur die fehlerhafte Platzierung eines Kunden reproduzieren kann, indem er dieselben sechs Zahlen eingibt, die die Pipeline gesendet hat. Zahlen Sie pro Aufruf $0.002 nur, wenn Sie automatisieren; Layouts auszuprobieren und eine konkrete fehlschlagende Koordinate zu debuggen kostet nichts.
Technische Fragen
Was passiert, wenn das Feld außerhalb der Seite liegt?
Die Anfrage schlägt mit einem invalid_input-Fehler fehl, dessen Meldung die überschrittene Grenze nennt und die beanstandeten Zahlen zeigt, etwa eine rechte Kante von 700pt auf einer 612pt breiten Seite.