Tải lên trước khi đính kèm
Tải lên các tệp thuộc một loại giấy tờ chứng minh hoặc tài liệu bổ trợ, rồi dùng các ID tệp được trả về để đính kèm qua create_proof hoặc create_supporting_document. Chỉ tải lên không tạo ra hồ sơ danh tính, địa chỉ, giấy tờ chứng minh hay hoàn tất việc đăng ký số. Hãy bắt đầu với các yêu cầu hiện hành và các ID trong danh mục.
Cung cấp đúng một tham số lựa chọn: proof_type_id cho giấy tờ chứng minh danh tính/địa chỉ, hoặc supporting_template_id cho tài liệu bổ trợ. Không gửi cả hai. Sử dụng các ID do danh mục MultiTEL tương ứng trả về; coi chúng là các mã định danh không mang ý nghĩa có thể suy diễn.
Yêu cầu tải lên
Sử dụng tài khoản API MultiTEL đã được kích hoạt và địa chỉ IP được phép của tài khoản đó. Các ví dụ sử dụng thông tin xác thực HTTP Basic lấy từ biến môi trường; hãy tuân theo quy ước xác thực dành cho loại tài khoản của bạn. Gửi yêu cầu qua HTTPS. Kiểm tra cả phản hồi HTTP và trường JSON status.code; lỗi ứng dụng có thể được trả về cùng HTTP 200. Các ví dụ dưới đây là giả định.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--form-string "proof_type_id=$PROOF_TYPE_ID" \
--form-string 'description=Identity proof' \
--form 'files[0]=@./identity-proof.pdf' \
https://api.multitel.net/v3/create_encrypt_files| Trường | Ý nghĩa |
|---|---|
files[0] … files[4] | Từ một đến năm tệp được tải lên. Sử dụng dữ liệu biểu mẫu nhiều phần và để curl tạo ranh giới phân tách cho Content-Type. Các trường này chứa các byte của tệp, không phải URL hay dữ liệu Base64 trong JSON. |
proof_type_id | Bắt buộc khi tải lên giấy tờ chứng minh; sử dụng ID loại giấy tờ chứng minh được trả về. Không gửi supporting_template_id. |
supporting_template_id | Bắt buộc đối với các tệp bổ trợ, thay cho proof_type_id; sử dụng ID mẫu được trả về. |
description | Mô tả tùy chọn do bên gọi cung cấp, tối đa 100 ký tự. Khi không có mô tả, lần tải lên tài liệu bổ trợ có thể sử dụng tên mẫu. |
Giới hạn tệp
Trình xử lý này chấp nhận tối đa năm tệp với tổng dung lượng 20,000,000 byte. Đây là giới hạn byte theo hệ thập phân, không phải 20 MiB. Hạ tầng hoặc việc kiểm tra MIME có thể áp dụng thêm các giới hạn khác.
Các phần mở rộng được phép là pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf và csv. Phần mở rộng được phép không có nghĩa là tệp đáp ứng yêu cầu đăng ký đã chọn. Cụ thể, tif không nằm trong danh sách cho phép này.
Kiểm tra từng tệp được trả về
{
"status": {
"code": 200,
"msg": "Encrypt file has been created successfully"
},
"response": {
"entity_type": "identities",
"document_category": "proof",
"proof_type": "11111111111111111111111111111111",
"ids": [
{
"id": "22222222222222222222222222222222",
"name": "identity-proof.pdf",
"expired_at": "2026-10-23 16:20:00"
}
]
}
}Lưu lại từng response.ids[].id để dùng trong yêu cầu đính kèm. name cho biết tên tệp nguồn được trả về. Sử dụng các tên tệp khác nhau và đối chiếu các tệp được trả về với tập tệp dự kiến: mã 200 có thể biểu thị một lô chỉ thành công một phần. Không đính kèm tập tệp còn thiếu các tệp bắt buộc.
entity_type có giá trị là identities hoặc addresses đối với giấy tờ chứng minh, và là supporting_documents đối với lần tải lên tài liệu bổ trợ. document_category có giá trị là proof hoặc supporting. Trường phản hồi có tên gọi chung là proof_type cũng chứa mã tham chiếu đến mẫu đối với lần tải lên tài liệu bổ trợ; hãy giữ lại supporting_template_id ban đầu để đính kèm.
Đính kèm sớm
Dịch vụ đặt thời điểm hết hạn vào khoảng 20 phút sau khi tệp tải lên được lưu trữ cục bộ. Khi đính kèm, hệ thống kiểm tra rằng tệp thuộc cùng tài khoản, chưa bị đánh dấu là hết hạn, vẫn chưa đến thời điểm hết hạn và có đúng loại thực thể. expired_at không có độ lệch múi giờ trong phản hồi này; đừng mặc định rằng giá trị đó theo UTC. Hãy đính kèm sớm thay vì lên lịch xử lý sát thời điểm hết hạn.
Việc mã tham chiếu tải lên hết hạn không có nghĩa là mọi bản sao tài liệu được lưu trữ đều được cam kết xóa vào thời điểm đó. Dịch vụ mã hóa các tệp để tải lên nhà mạng và giữ lại các byte gốc cho quy trình tài liệu; không coi đây là mã hóa chỉ ở phía máy khách hay dịch vụ không lưu giữ dữ liệu. Không đưa ID, tên tệp và phản hồi vào nhật ký công khai.
Lỗi và thử lại
Trình xử lý hiện tại sử dụng mã API 404 khi không có tệp tài liệu nào được cung cấp, và mã 500 cho lỗi kiểm tra mô tả, tham số lựa chọn bị thiếu hoặc xung đột, ID loại giấy tờ chứng minh/mẫu không hợp lệ, vượt giới hạn số lượng tệp hoặc tổng dung lượng, sự cố lưu trữ hoặc tải lên không thành công. Đọc status.msg; dữ liệu đầu vào không hợp lệ không phải lúc nào cũng được biểu thị bằng mã 400.
Tại đây không cung cấp khóa bảo đảm tính lũy đẳng cho máy khách. Nếu mất phản hồi, hãy kiểm tra quy trình tài liệu trước khi tải lên lại; một yêu cầu khác có thể tạo ra các mã tham chiếu tệp mới. Các ví dụ này chưa được thực thi với giấy tờ định danh của khách hàng.