API

Phát hiện tệp

Kiểm tra tệp với các dấu đang hoạt động trong không gian làm việc Business hoặc Enterprise.

POST/api/v1/detect

Kiểm tra tệp trong không gian làm việc thuộc khóa này. Nội dung yêu cầu là multipart/form-data.

Xác thực

Authorization: Bearer mf_…

Gửi dòng header này. Không có cookie phiên. curl và máy khách máy chủ khác được chấp nhận. Trình duyệt từ trang khác bị từ chối.

Tham số

TênLoạiBắt buộcGiải thích
filefileCóTệp sẽ kiểm tra. Khớp chỉ được tìm trong không gian thuộc khóa này. Tệp đánh dấu ở không gian khác không được nhận ra. Không gian Business hoặc Enterprise đang hoạt động cũng có thể kiểm tra tệp video. Ảnh một khung hình được kiểm tra bằng hình ảnh.

Yêu cầu

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

Phản hồi

{
  "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à mã định danh bạn ghi khi bản sao được đánh dấu, hoặc null nếu không có khớp trong không gian này. confidence là 99% trên tệp nguyên vẹn hoặc khi dấu đã xác thực khớp với dấu khác. Chỉ khớp hình ảnh thì vẫn thấp hơn. layers cho thấy lớp và hit thành true trên lớp khớp. notes giải thích việc kiểm tra đã làm gì. Tệp đã xóa không được nhận ra.

Lỗi

Văn bản ở cột error trong phản hồi JSON là tiếng Anh.

Trạng tháiGiải thích
400Tệp trống.
401Khóa không có, khóa đã thu hồi, hoặc không được nhận ra. Phản hồi JSON chứa "code": "api-key".
403Không gian làm việc không còn gói Business hoặc Enterprise đang hoạt động (phản hồi chứa "code": "enterprise") hoặc trình duyệt gửi yêu cầu cross-site hoặc same-site.
413Tệp vượt giới hạn tải lên của gói, hoặc PDF có nhiều trang hơn mức gói cho phép.
422Tệp không thể xử lý.
429Khóa này thực hiện hơn 80 lần phát hiện trong cùng một phút.

Giới hạn lệnh gọi

80 yêu cầu mỗi phút cho khóa này. Bộ đếm nằm trong cơ sở dữ liệu sản phẩm và vẫn còn sau khi khởi động lại.