API

Rileva un file

Verifica un file rispetto alle marche attive di uno spazio di lavoro Business o Enterprise.

POST/api/v1/detect

Verifica un file nello spazio di lavoro di questa chiave. Il corpo è multipart/form-data.

Autenticazione

Authorization: Bearer mf_…

Invia questa intestazione. Non c'è un cookie di sessione. curl e gli altri client da server sono accettati. Un browser su un altro sito viene rifiutato.

Parametri

NomeTipoObbligatorioDescrizione
filefileSìIl file da verificare. La corrispondenza viene cercata solo nello spazio di lavoro di questa chiave. Un file marcato in un altro spazio di lavoro non viene identificato. Uno spazio Business o Enterprise attivo può anche verificare un file video. Lo screenshot di un singolo fotogramma viene verificato come immagine.

Richiesta

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

Risposta

{
  "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 è l'identificatore che hai definito quando quella copia è stata marcata, o null quando questo spazio di lavoro non ha una corrispondenza. confidence è del 99% per un file esatto o quando una marca autenticata concorda con un'altra marca. Una corrispondenza solo visiva resta più bassa. layers elenca i livelli, e hit è true in quelli che hanno concordato. notes descrive cosa ha fatto la verifica. Un file eliminato non viene identificato.

Errori

Il testo del campo error nel corpo JSON è in inglese.

StatoDescrizione
400Il file è vuoto.
401La chiave manca, è stata revocata o è sconosciuta. Il corpo JSON include "code": "api-key".
403Lo spazio di lavoro non ha più un piano Business o Enterprise attivo (il corpo include "code": "enterprise"), oppure il browser ha inviato una richiesta cross-site o same-site.
413Il file supera il limite di caricamento del piano, oppure il PDF ha più pagine di quante il piano consenta.
422Non è stato possibile elaborare il file.
429Questa chiave ha fatto più di 80 rilevamenti nel minuto attuale.

Limite di richieste

80 richieste al minuto per questa chiave. Il contatore sta nel database del prodotto e resta valido dopo un riavvio.