API

Deteksi file

Periksa file terhadap tanda aktif di ruang kerja Business atau Enterprise.

POST`/api/v1/detect`

Memeriksa file di ruang kerja milik kunci ini. Isi permintaan adalah multipart/form-data.

Autentikasi

Authorization: Bearer mf_…

Kirim baris header ini. Tidak ada cookie sesi. curl dan klien server lain diterima. Peramban dari halaman lain ditolak.

Parameter

Nama	Jenis	Wajib	Penjelasan
file	file	Ya	File yang akan diperiksa. Kecocokan hanya dicari di ruang milik kunci ini. File yang ditandai di ruang lain tidak dikenali. Ruang Business atau Enterprise yang aktif juga bisa memeriksa file video. Gambar satu bingkai diperiksa secara visual.

Permintaan

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

Respons

{
  "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 adalah pengenal yang kamu tulis saat salinan ditandai, atau null jika tidak ada kecocokan di ruang ini. confidence adalah 99% pada file utuh atau saat tanda terautentikasi cocok dengan tanda lain. Kecocokan visual saja tetap lebih rendah. layers menunjukkan lapisan dan hit menjadi true pada yang cocok. notes menjelaskan apa yang dilakukan pemeriksaan. File yang dihapus tidak dikenali.

Kesalahan

Teks pada kolom error di respons JSON berbahasa Inggris.

Status	Penjelasan
400	File kosong.
401	Kunci tidak ada, kunci dicabut, atau tidak dikenal. Respons JSON berisi "code": "api-key".
403	Ruang kerja tidak lagi punya paket Business atau Enterprise yang aktif (respons berisi "code": "enterprise") atau peramban mengirim permintaan cross-site atau same-site.
413	File melebihi batas unggah paket, atau PDF berisi lebih banyak halaman daripada yang diizinkan paket.
422	File tidak dapat diproses.
429	Kunci ini melakukan lebih dari 80 deteksi dalam menit yang sama.

Batas panggilan

80 permintaan per menit untuk kunci ini. Penghitung ada di basis data produk dan tetap ada setelah mulai ulang.