API

Wykryj plik

Sprawdź plik względem aktywnych oznaczeń obszaru Business albo Enterprise.

POST/api/v1/detect

Sprawdza plik w obszarze roboczym tego klucza. Treść to multipart/form-data.

Uwierzytelnianie

Authorization: Bearer mf_…

Wyślij ten nagłówek. Nie ma pliku cookie sesji. curl i inni klienci serwerowi są przyjmowani. Przeglądarka na innej stronie jest odrzucana.

Parametry

NazwaTypWymaganeOpis
filefileTakPlik do sprawdzenia. Trafienia szuka się tylko w obszarze tego klucza. Plik oznaczony w innym obszarze nie zostanie rozpoznany. Aktywny obszar Business albo Enterprise może też sprawdzić plik wideo. Zrzut jednej klatki jest sprawdzany jako obraz.

Żądanie

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

Odpowiedź

{
  "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 to identyfikator, który podałeś, gdy kopia była oznaczana, albo null, gdy ten obszar nie ma trafienia. confidence to 99% dla dokładnego pliku albo gdy uwierzytelniony znak zgadza się z innym znakiem. Samo trafienie wizualne zostaje niżej. layers pokazuje warstwy, a hit jest true dla tych, które się zgadzają. notes opisuje, co zrobiło sprawdzenie. Usunięty plik nie jest rozpoznawany.

Błędy

Tekst pola error w odpowiedzi JSON jest po angielsku.

StanOpis
400Plik jest pusty.
401Brak klucza, klucz unieważniony albo nieznany. Odpowiedź JSON zawiera "code": "api-key".
403Obszar nie ma już aktywnego planu Business albo Enterprise (odpowiedź zawiera "code": "enterprise"), albo przeglądarka wysłała żądanie cross-site albo same-site.
413Plik przekracza limit wgrywania planu, albo PDF ma więcej stron, niż plan pozwala.
422Pliku nie dało się przetworzyć.
429Ten klucz wykonał ponad 80 wykryć w bieżącej minucie.

Limit wywołań

80 żądań na minutę dla tego klucza. Licznik jest w bazie produktu i zostaje po restarcie.