API

Dosyayı tespit et

Bir dosyayı Business veya Enterprise çalışma alanının aktif işaretlerine karşı kontrol et.

POST/api/v1/detect

Bu anahtarın çalışma alanındaki bir dosyayı kontrol eder. Gövde multipart/form-data'dır.

Kimlik doğrulama

Authorization: Bearer mf_…

Bu başlık satırını gönder. Oturum çerezi yoktur. curl ve diğer sunucu istemcileri kabul edilir. Başka bir sayfadaki tarayıcı reddedilir.

Parametreler

AdTürZorunluAçıklama
filefileEvetKontrol edilecek dosya. Eşleşme yalnızca bu anahtarın alanında aranır. Başka bir alanda işaretlenen dosya tanınmaz. Aktif bir Business veya Enterprise alanı bir video dosyasını da kontrol edebilir. Tek bir karenin görüntüsü görsel olarak kontrol edilir.

İstek

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

Yanıt

{
  "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, kopya işaretlenirken yazdığın tanımlayıcıdır ya da bu alanda eşleşme yoksa null. confidence tam dosyada veya doğrulanmış bir işaret başka bir işaretle uyuşunca %99'dur. Yalnızca görsel eşleşme daha düşük kalır. layers katmanları gösterir ve hit eşleşenlerde true olur. notes kontrolün ne yaptığını anlatır. Silinen bir dosya tanınmaz.

Hatalar

JSON yanıtındaki error alanının metni İngilizcedir.

DurumAçıklama
400Dosya boş.
401Anahtar yok, anahtar iptal edilmiş veya bilinmiyor. JSON yanıtı "code": "api-key" içerir.
403Çalışma alanının artık aktif bir Business veya Enterprise planı yok (yanıt "code": "enterprise" içerir) ya da tarayıcı cross-site veya same-site bir istek gönderdi.
413Dosya planın yükleme limitini aşıyor ya da PDF, planın izin verdiğinden fazla sayfa içeriyor.
422Dosya işlenemedi.
429Bu anahtar aynı dakika içinde 80 tespitten fazla yaptı.

Çağrı limiti

Bu anahtar için dakikada 80 istek. Sayaç ürün veritabanındadır ve yeniden başlatmadan sonra kalır.