API

Detectar um arquivo

Verifique um arquivo em relação às marcas ativas de um espaço de trabalho Business ou Enterprise.

POST/api/v1/detect

Verifica um arquivo no espaço de trabalho desta chave. O corpo é multipart/form-data.

Autenticação

Authorization: Bearer mf_…

Envie este cabeçalho. Não há cookie de sessão. O curl e outros clientes de servidor são aceitos. Um navegador em outro site é recusado.

Parâmetros

NomeTipoObrigatórioDescrição
filefileSimO arquivo a ser verificado. A correspondência é procurada só no espaço de trabalho desta chave. Um arquivo marcado em outro espaço de trabalho não é identificado. Um espaço Business ou Enterprise ativo também pode verificar um arquivo de vídeo. A captura de tela de um único quadro é verificada como imagem.

Requisição

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

Resposta

{
  "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 é o identificador que você definiu quando essa cópia foi marcada, ou null quando este espaço de trabalho não tem correspondência. confidence é de 99% para um arquivo exato ou quando uma marca autenticada concorda com outra marca. Uma correspondência apenas visual fica mais baixa. layers lista as camadas, e hit é true nas que concordaram. notes descreve o que a verificação fez. Um arquivo excluído não é identificado.

Erros

O texto do campo error no corpo JSON está em inglês.

StatusDescrição
400O arquivo está vazio.
401A chave está ausente, foi revogada ou é desconhecida. O corpo JSON inclui "code": "api-key".
403O espaço de trabalho não tem mais um plano Business ou Enterprise ativo (o corpo inclui "code": "enterprise"), ou o navegador enviou uma requisição cross-site ou same-site.
413O arquivo passa do limite de envio do plano, ou o PDF tem mais páginas do que o plano permite.
422Não foi possível processar o arquivo.
429Esta chave fez mais de 80 detecções no minuto atual.

Limite de requisições

80 requisições por minuto para esta chave. O contador fica no banco de dados do produto e continua valendo depois de uma reinicialização.