API

Marquer un fichier

Marque un fichier dans un espace Enterprise et télécharge la copie marquée.

POST`/api/v1/mark`

Marque un fichier et renvoie la copie marquée. Le corps est multipart/form-data.

Authentification

Authorization: Bearer mf_…

Envoie cet en-tête. Il n'y a pas de cookie de session. curl et les autres clients serveur sont acceptés. Un navigateur sur un autre site est refusé.

Paramètres

Nom	Type	Obligatoire	Description
file	file	Oui	Le fichier à marquer. Enterprise accepte jusqu'à 100 MB, 500 pages PDF et une vidéo jusqu'à 10 minutes. La taille, la durée et le nombre de pages suivent la formule de l'espace.
identifier	string	Oui	1 à 32 caractères, sans caractère de contrôle. L'étiquette que tu vois si cette copie est détectée plus tard. Elle n'est pas écrite dans le fichier comme texte lisible.

Requête

curl -X POST https://markedfile.com/api/v1/mark \
  -H "Authorization: Bearer mf_…" \
  -F "file=@contract.pdf" \
  -F "identifier=northwind"

Réponse

{
  "file": "JVBERi0xLjQK…",
  "mime": "application/pdf",
  "name": "contract.pdf",
  "kind": "pdf",
  "layers": [
    {
      "name": "Metadata",
      "detail": "Authenticated workspace reference; the identifier stays on the server",
      "screenshot": "No",
      "crop": "No",
      "reencode": "No"
    }
  ],
  "remaining": 1
}

file contient les octets marqués en base64. mime, name et kind décrivent le téléchargement. layers liste les couches qui ont été appliquées. Quand la formule n'a pas de plafond de fichiers actifs, remaining est le nombre de fichiers actifs après cette marque. Quand elle a un plafond, remaining est le nombre de nouvelles marques restantes. Enterprise n'a pas de plafond. Supprimer un fichier est ce qui arrête la détection.

Erreurs

Le texte du champ error dans le corps JSON est en anglais.

État	Description
400	Le fichier est vide, ou l'identifiant est vide, dépasse 32 caractères ou contient un caractère de contrôle.
401	La clé manque, est révoquée ou est inconnue. Le corps JSON contient "code": "api-key".
403	L'espace n'a plus de formule Enterprise active (le corps contient "code": "enterprise"), ou le navigateur a envoyé une requête cross-site ou same-site.
413	Le fichier dépasse la limite d'envoi de la formule, ou le PDF a plus de pages que la formule n'en permet.
422	Le fichier n'a pas pu être traité.
429	Cette clé a marqué plus de 40 fichiers dans la minute en cours.

Limite

40 requêtes par minute pour cette clé. Le compteur est dans la base du produit et survit à un redémarrage.