API

Détecter un fichier

Vérifie un fichier contre les marques actives d'un espace Enterprise.

POST/api/v1/detect

Vérifie un fichier dans l'espace de cette clé. 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

NomTypeObligatoireDescription
filefileOuiLe fichier à vérifier. La recherche ne se fait que dans l'espace de cette clé. Un fichier marqué dans un autre espace ne se résout pas. Un espace Enterprise actif peut aussi vérifier un fichier vidéo. Une capture d'une seule image est vérifiée comme une image.

Requête

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

Réponse

{
  "id": "northwind",
  "confidence": 0.95,
  "layers": [
    {
      "name": "Metadata",
      "hit": true,
      "detail": "Authenticated metadata matched this workspace",
      "screenshot": "No",
      "crop": "No",
      "reencode": "No"
    }
  ],
  "notes": [
    "Confidence is 99% for an exact file or when an authenticated mark agrees with another mark. A visual match alone stays lower, and weak bit agreement stays far from a high score."
  ]
}

id est l'identifiant que tu as choisi quand cette copie a été marquée, ou null si cet espace n'a pas de correspondance. confidence est de 99 % pour un fichier exact ou quand une marque authentifiée concorde avec une autre marque. Une correspondance seulement visuelle reste plus basse. layers liste les couches, et hit est vrai pour celles qui ont concordé. notes décrit ce que la vérification a fait. Un fichier supprimé ne se résout pas.

Erreurs

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

ÉtatDescription
400Le fichier est vide.
401La clé manque, est révoquée ou est inconnue. Le corps JSON contient "code": "api-key".
403L'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.
413Le fichier dépasse la limite d'envoi de la formule, ou le PDF a plus de pages que la formule n'en permet.
422Le fichier n'a pas pu être traité.
429Cette clé a fait plus de 80 détections dans la minute en cours.

Limite

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