Liệt kê các mã tham chiếu tải lên còn khả dụng
Sử dụng điểm cuối này sau khi tải tài liệu đăng ký lên khi bạn cần tìm các mã tham chiếu vẫn còn dùng được để đính kèm. 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 địa chỉ IP đã cấu hình cho tài khoản đó. Danh sách chỉ bao gồm dữ liệu thuộc tài khoản của bạn.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesKhông cần phần thân yêu cầu hoặc tham số truy vấn. Trình xử lý liệt kê các bản ghi tải lên được tạo qua API có cờ hết hạn chưa được bật và thời điểm hết hạn nằm sau thời gian hiện tại của máy chủ. Điểm cuối không cung cấp tham số phân trang, tìm kiếm hoặc sắp xếp. Đây không phải là danh sách tất cả hồ sơ danh tính, giấy tờ chứng minh hoặc tài liệu trước đây trong tài khoản của bạn.
Đọc siêu dữ liệu, không phải dữ liệu byte của tài liệu
Đọc kết quả HTTP và trường status.code trong JSON. Phản hồi thành công chứa một mảng trong response; kết quả trống là một mảng rỗng, không phải lỗi không tìm thấy tài khoản. Ví dụ sử dụng siêu dữ liệu và mã định danh giả định.
{
"status": {"code": 200, "msg": ""},
"response": [{
"id": "0123456789abcdef0123456789abcdef",
"proof_type": "abcdef0123456789abcdef0123456789",
"entity_type": "addresses",
"description": "Example address proof",
"file_name": "example-document.pdf",
"date": "2026-10-01 12:00:00"
}]
}| Trường | Ý nghĩa |
|---|---|
id | Mã tham chiếu bên ngoài của tệp tải lên. Sao chép chính xác mã này để dùng trong yêu cầu đính kèm tương ứng. Không tự tính mã định danh hoặc thay bằng mã định danh của hồ sơ danh tính, địa chỉ hay mẫu. |
proof_type | Mã tham chiếu loại đã ghi nhận ở dạng che giấu nếu có, nếu không thì là chuỗi rỗng. Đối với tệp giấy tờ chứng minh tải lên, đây là loại giấy tờ chứng minh; đối với tệp tài liệu bổ trợ tải lên, mã tham chiếu mẫu được ghi dưới cùng khóa này. Đọc entity_type để phân biệt hai trường hợp. Đây không phải là mã định danh của tệp tải lên. |
entity_type | Nhóm đính kèm đã ghi nhận, chẳng hạn như identities, addresses hoặc supporting_documents. Chọn quy trình đính kèm tương ứng. |
description | Mô tả đã lưu của tệp tải lên. |
file_name | Tên tệp gốc. Đây không phải là địa chỉ tải xuống. |
date | Thời điểm tạo đã ghi nhận, được máy chủ định dạng mà không kèm độ lệch múi giờ. |
Phản hồi không chứa dữ liệu byte của tài liệu, địa chỉ lưu trữ hoặc thời hạn hết hiệu lực. Hãy lưu lại expired_at từ phản hồi tải lên ban đầu. Việc một tệp tải lên xuất hiện trong danh sách không gia hạn hiệu lực của tệp đó, không đính kèm tệp vào hồ sơ danh tính và cũng không chứng minh rằng nhà mạng đã phê duyệt tệp.
Đính kèm trước khi mã tham chiếu hết hạn
Sử dụng quy trình đính kèm giấy tờ chứng minh hoặc đính kèm tài liệu bổ trợ phù hợp. Quy trình tải lên hiện tại chỉ cấp cho các mã tham chiếu một khoảng thời gian hiệu lực ngắn; đừng trì hoãn việc đính kèm chỉ vì một mã tham chiếu đã xuất hiện trong danh sách này. Mã tham chiếu có thể hết hạn hoặc không còn khả dụng trong khoảng thời gian từ lúc liệt kê đến lúc đính kèm. Hãy xử lý phản hồi của yêu cầu đính kèm thay vì mặc định rằng thao tác đã thành công.
Nếu danh sách trống ngoài dự kiến, hãy kiểm tra tài khoản và xem tệp tải lên đã hết hạn hay được tạo qua một quy trình khác hay chưa. Không tự động tải lại cùng các tài liệu khi chưa kiểm tra kết quả tải lên ban đầu và kết quả đính kèm.
Quyền riêng tư
Tên tệp và mô tả có thể giúp nhận diện người hoặc tài liệu ngay cả khi không có nội dung tệp. Hãy hạn chế quyền truy cập và tránh ghi toàn bộ phản hồi vào nhật ký. Để xóa một mã tham chiếu tải lên cục bộ chưa sử dụng, xem xóa mã tham chiếu tải lên; thao tác đó không phải là dịch vụ xóa tài liệu toàn diện.