Chọn tham chiếu tải lên không còn dùng
Điểm cuối này xóa một bản ghi tham chiếu tải lên thuộc tài khoản của bạn. Chỉ sử dụng khi bạn chắc chắn không còn cần tham chiếu đó cho việc đính kèm bằng chứng hoặc việc đính kèm tài liệu bổ trợ. Thao tác này không xóa danh tính hoặc địa chỉ đã đăng ký.
Lấy mã định danh tệp bên ngoài từ phản hồi tải lên ban đầu hoặc danh sách các bản tải lên hiện có. Trước tiên, trình xử lý tra cứu mã định danh đó trong tài khoản của bạn; nếu không tìm thấy, trình xử lý sẽ tra cứu bằng mã định danh của nhà cung cấp theo cơ chế cũ. Các tích hợp mới nên sử dụng tham chiếu bên ngoài đúng như giá trị được trả về. Không cần phần thân yêu cầu.
Chủ động yêu cầu xóa
Sử dụng tài khoản API MultiTEL đã được kích hoạt qua HTTPS, với thông tin xác thực và các giới hạn IP đã cấu hình cho tài khoản đó. Sử dụng POST để ứng dụng của bạn coi đây là một thay đổi có chủ đích:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefTrình xử lý hiện tại không áp dụng giới hạn về phương thức HTTP: yêu cầu GET cũng có thể dẫn đến thao tác xóa. Không đưa URL này vào ứng dụng dưới dạng liên kết có thể nhấp thông thường, hình ảnh, dấu trang, nội dung xem trước hoặc đích tìm nạp trước. Ứng dụng của bạn phải yêu cầu thao tác xóa rõ ràng và không được tự động thử lại.
Hiểu kết quả và các giới hạn của kết quả
Đọc cả kết quả HTTP và trường status.code trong JSON. Phản hồi thành công thông thường là:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Mã API 404 kèm theo Failed, Not found có nghĩa là cả hai lần tra cứu đều không tìm thấy tham chiếu phù hợp cho tài khoản này. Vì vậy, việc yêu cầu xóa lại có thể trả về 404. Các khoảng trắng ở đầu và cuối giá trị trong đường dẫn sẽ được loại bỏ. Tại đây không có bước kiểm tra xem tham chiếu còn hạn hay có đang được bước khác sử dụng hay không, nên hãy kiểm tra kỹ quy trình của bạn trước khi xóa tham chiếu.
Trình xử lý báo thành công sau khi thử xóa trong cơ sở dữ liệu mà không kiểm tra xem thao tác xóa đó có thành công hay không. Hãy coi phản hồi là kết quả được báo cáo, chứ không phải bằng chứng độc lập về việc dữ liệu đã được xóa. Nếu một tham chiếu còn hạn do API tạo từng xuất hiện trong get_encrypted_files, danh sách đó có thể giúp kiểm tra xem tham chiếu có còn xuất hiện hay không, nhưng việc không có trong danh sách cũng có thể là do tham chiếu đã hết hạn.
Thao tác xóa này không xóa hoàn toàn dữ liệu
Trình xử lý thực hiện lệnh xóa trên bảng tham chiếu tải lên. Trình xử lý không trực tiếp xóa hàng lưu nội dung tài liệu, tệp đã tải lên được lưu cục bộ, bằng chứng đã đính kèm, danh tính, tài liệu bổ trợ hoặc bản sao do nhà cung cấp lưu giữ. Cơ chế xóa dây chuyền trong cơ sở dữ liệu và hành vi lưu giữ dữ liệu chưa được xác minh. Không mô tả thao tác này với người dùng là xóa mọi bản sao giấy tờ định danh của họ hoặc đáp ứng yêu cầu xóa dữ liệu toàn diện.
Sau khi tham chiếu cục bộ bị xóa, các bước đính kèm tiếp theo cần dùng tham chiếu đó có thể thất bại. Hãy giữ lại kết quả của những bước đính kèm đã hoàn tất và sử dụng quy trình quản lý danh tính hoặc bằng chứng phù hợp khi thay đổi thông tin đăng ký đã gửi.