CopySeal
API-Dokumentation

CopySeal API-Referenz

Integrieren Sie unsichtbare Wasserzeichen in Ihre Anwendungen

POST/embedAuthentifizierung

Alle API-Anforderungen erfordern eine Authentifizierung über einen API-Schlüssel oder Session-Cookie. Fügen Sie Ihren API-Schlüssel in den Anforderungsheader ein:

Beispiel

curl -X POST https://copyseal.online/embed \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@example.png" \
  -F "watermarkText=hello"

API-Schlüssel sind in Business- und Enterprise-Plänen verfügbar. Free- und Creator-Benutzer können das Web-Dashboard oder die sitzungsbasierte Authentifizierung verwenden.

Lädt…

POST/embedWasserzeichen einbetten

Unsichtbaren Wasserzeichentext in einem Bild oder PDF verstecken. Der vereinheitlichte Endpunkt akzeptiert beide Formate per Content-Type-Dispatch.

Anfrage

Content-Type: multipart/form-data

{
  "file":           <binary>,   // Image (PNG/JPG/WebP) or PDF
  "watermarkText":  "string",   // Text to hide
}

Antwort

{
  "id":               "uuid",
  "file_type":        "image" | "pdf",
  "wm_shape":         42,
  "watermark_content": "hello",
  "download_url":     "/api/download/{id}",
  "expires_at":       "2024-01-02T00:00:00Z"
}

Beispiel (cURL)

curl -X POST https://copyseal.online/embed \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@example.png" \
  -F "watermarkText=hello"

POST /embed verteilt anhand des Content-Type der hochgeladenen Datei: image/* führt den Bild-Zweig aus (watermarkText erforderlich) und application/pdf führt den PDF-Zweig aus (watermarkText optional, nur Tracer). Die Antwortform ist immer dieselbe — Bild-Felder (wm_shape, watermark_content) oder PDF-Felder (key_id, pages_marked, page_count, frame) werden je nach Upload befüllt, der andere Satz ist null.

POST/extractWasserzeichen extrahieren

Das verborgene Wasserzeichen aus einem zuvor eingebetteten Bild offenlegen.

Anfrage

Content-Type: multipart/form-data

{
  "file":        <binary>,
  "wmShape":     42,
}

Antwort

{
  "watermark_content": "Copyright 2024"
}

Beispiel (cURL)

curl -X POST https://copyseal.online/extract \
  -H "Authorization: Bearer wsk_your_api_key" \
  -F "file=@watermarked_photo.png" \
  -F "wmShape=42"

POST/extract/pdfPDF-Wasserzeichen extrahieren

Extrahiere die pro-Seite key_id aus einem wasserzeichenmarkierten PDF. Verwende die key_id, um zu verfolgen, welcher Benutzer/welches Konto die Datei eingebettet hat.

Anfrage

curl -X POST https://copyseal.online/extract/pdf \
  -H "Authorization: Bearer wsk_your_api_key" \
  -H "Content-Type: application/pdf" \
  --data-binary "@watermarked_contract.pdf"

Antwort

{
  "key_id":    "8f3a2b1c4d5e6f70",
  "frame":     0,
  "page_index": 3,
  "plaintext": "optional-payload"
}

Gibt 404 zurück, wenn kein Wasserzeichen gefunden wird oder die key_id nicht zum authentifizierten Benutzer gehört.

Ratenbegrenzungen

API-Ratenbegrenzungen hängen von Ihrem Abonnementplan ab.

TierMonthlyFile sizeAPI/dayBatch
Free55MB----
Creator10025MB--10
Business50050MB10050
Enterprise2,000100MBUnlimited500

Fehlercodes

401Nicht autorisiertShow details

Nicht autorisiert - Ungültiger oder fehlender API-Schlüssel

403VerbotenShow details

Verboten - Funktion in Ihrem Plan nicht verfügbar

429Zu viele AnfragenShow details

Zu viele Anfragen - Monatliches Bildlimit erreicht

500Interner ServerfehlerShow details

Interner Serverfehler - Verarbeitung fehlgeschlagen

Bereit loszulegen?

Erstellen Sie ein kostenloses Konto und beginnen Sie mit dem Schutz Ihrer Bilder.