CopySeal
Documentation API

Référence API CopySeal

Intégrez le filigranage invisible dans vos applications

POST/embedAuthentification

Toutes les requêtes API nécessitent une authentification via une clé API ou un cookie de session. Incluez votre clé API dans l'en-tête de la requête :

Exemple

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

Les clés API sont disponibles avec les formules Business et Enterprise. Les utilisateurs Free et Creator peuvent utiliser le tableau de bord web ou l'authentification par session.

Chargement…

POST/embedIntégrer un filigrane

Masquez un texte de filigrane invisible dans une image ou un PDF. Le point d'accès unifié accepte les deux formats via une répartition par Content-Type.

Requête

Content-Type: multipart/form-data

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

Réponse

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

Exemple (cURL)

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

POST /embed répartit selon le Content-Type du fichier téléchargé : image/* exécute la branche image (watermarkText requis) et application/pdf exécute la branche PDF (watermarkText optionnel, traçage seul). La forme de la réponse est toujours la même — les champs image (wm_shape, watermark_content) ou les champs PDF (key_id, pages_marked, page_count, frame) sont renseignés selon le téléchargement, l'autre ensemble étant null.

POST/extractExtraire le filigrane

Révélez le filigrane caché d'une image précédemment intégrée.

Requête

Content-Type: multipart/form-data

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

Réponse

{
  "watermark_content": "Copyright 2024"
}

Exemple (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/pdfExtraire un filigrane PDF

Extrayez la key_id par page d'un PDF filigrané. Utilisez la key_id pour retracer quel utilisateur/compte a intégré le fichier.

Requête

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"

Réponse

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

Renvoie 404 si aucun filigrane n'est trouvé ou si la key_id n'appartient pas à l'utilisateur authentifié.

Limites de débit

Les limites de débit API dépendent de votre formule d'abonnement.

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

Codes d'erreur

401Non autoriséShow details

Non autorisé - Clé API invalide ou manquante

403InterditShow details

Interdit - Fonctionnalité non disponible avec votre formule

429Trop de requêtesShow details

Trop de requêtes - Limite mensuelle d'images atteinte

500Erreur interne du serveurShow details

Erreur interne du serveur - Le traitement a échoué

Prêt à commencer ?

Créez un compte gratuit et commencez à protéger vos images.