Tài liệu API Fileverity
Lưu giữ dữ liệu và bảo mật
Fileverity API lưu những gì và trong bao lâu: tệp tải lên, kết quả, văn bản, nhật ký yêu cầu và các lần gửi webhook, cùng cách bảo vệ khóa và endpoint.
Xem dạng MarkdownCập nhật 2026-11-04
Trang này liệt kê những gì API lưu giữ và thời gian lưu giữ. Để có cái nhìn tổng thể hơn, hãy xem Tin cậy và bảo mật.
Thời gian lưu giữ
| Dữ liệu | Thời gian lưu giữ | Ghi chú |
|---|---|---|
| Tệp tải lên | Bị xóa khi một lượt phân tích bắt đầu, và chậm nhất sau 24 giờ | Được lưu riêng tư. DELETE /files/{id} xóa tệp sớm hơn. |
Văn bản bạn gửi tới POST /text/detections | Không được lưu | Được đánh giá rồi loại bỏ. Văn bản không bao giờ được lưu nên không thể truy xuất lại sau này. |
| Kết quả phát hiện văn bản (không bao giờ gồm chính văn bản) | 7 ngày | Kết luận, điểm số, vị trí (offset) của các đoạn và mức sử dụng. Hiển thị trong Lịch sử kiểm tra của Console. Khóa thử nghiệm không ghi lại gì. |
| Kết quả phân tích | 7 ngày | Sau đó kết quả bị xóa. Bản ghi xác minh của báo cáo vẫn còn. |
| Bằng chứng của tài liệu (ảnh các trang, đoạn trích văn bản) | 3 giờ | Hãy tải báo cáo PDF trước thời điểm đó để giữ lại bằng chứng trong báo cáo. |
| Nhật ký yêu cầu | 30 ngày | Phương thức, path, trạng thái, thời lượng, mã lỗi và khóa. Không gồm nội dung yêu cầu hay nội dung phản hồi. |
| Nhật ký gửi webhook | 30 ngày | Nội dung yêu cầu (payload) của sự kiện, trạng thái, thời gian phản hồi và 2 KB đầu tiên của phản hồi từ endpoint của bạn. 50 lần gần nhất được hiển thị trong Console. |
| Bản ghi idempotency | 24 giờ | Phản hồi đã lưu, dùng để phát lại khi một yêu cầu được thử lại. Với phát hiện văn bản, đó là kết quả không kèm văn bản. |
Biện pháp bảo vệ
- Chỉ dùng HTTPS. Toàn bộ lưu lượng API đều dùng HTTPS.
- Khóa. Chỉ lưu giá trị băm SHA-256 và bốn ký tự cuối của khóa. Khóa có thể bị thu hồi bất cứ lúc nào. Xem Xác thực và khóa API.
- Cô lập theo không gian làm việc. Tệp, lượt phân tích, khóa, webhook và nhật ký thuộc về một không gian làm việc và một chế độ; khóa thật và khóa thử nghiệm không thể đọc tệp của nhau.
- Hạn mức chi tiêu. Hạn mức hằng tháng theo từng khóa giới hạn số tiền mà một khóa bị lộ có thể chi tiêu.
- Webhook. Các lần gửi được ký bằng khóa bí mật riêng của từng endpoint. Endpoint phải dùng HTTPS và địa chỉ công khai; địa chỉ riêng tư và nội bộ bị từ chối. Hệ thống không đi theo các chuyển hướng (redirect).
- Báo cáo có thể xác minh. Báo cáo ảnh và tài liệu có mã báo cáo, giá trị băm SHA-256 và dấu thời gian RFC 3161, cùng một trang xác minh công khai.
Enterprise
Triển khai riêng được cung cấp cho khách hàng Enterprise theo yêu cầu. Liên hệ với chúng tôi để trao đổi.
Pháp lý
Xem Chính sách quyền riêng tư, Điều khoản sử dụng và Thỏa thuận xử lý dữ liệu.