Đọc một hồ sơ đã lưu
Truy xuất hồ sơ đăng ký cục bộ đang hoạt động được chọn bằng UUID trong tài khoản của bạn. Thao tác này trả về cùng tập hợp trường hồ sơ giới hạn như documents; thao tác này không cập nhật kết quả xác minh của nhà mạng và không trả về các giấy tờ chứng minh đã đính kèm.
Yêu cầu đọc hồ sơ
Xác thực bằng tài khoản API MultiTEL đã được kích hoạt của bạn 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 được lưu trong các biến môi trường. Kiểm tra cả phản hồi HTTP lẫn trường JSON status.code; chỉ riêng phản hồi HTTP 200 không đủ để xác nhận thành công. Tất cả giá trị trong ví dụ đều là giả định.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_document/$DOCUMENT_UUID"Đặt DOCUMENT_UUID thành giá trị response.uuid từ create_document, hoặc giá trị response[].id từ documents. Không sử dụng identity_id, address_id, mã định danh của giấy tờ chứng minh hoặc số điện thoại ở đây. Không cần phần thân yêu cầu.
Phản hồi hồ sơ
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"id": "11111111111111111111111111111111",
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"id_number": "",
"birth_date": null,
"company_name": "",
"company_reg_number": "",
"vat_id": "",
"personal_tax_id": "",
"description": "Example profile",
"identity_type": "Personal",
"postal_code": "00000",
"city": "Example City",
"address": "1 Example Street",
"signature": "BASE64_PNG_SIGNATURE_DATA",
"date_created": "2026-10-23 16:00:00"
}
}Các trường hồ sơ được trả về
Tập hợp trường được trả về bao gồm id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature và date_created.
Các giá trị không bắt buộc có thể để trống hoặc là null tùy theo dữ liệu đã lưu. Tập hợp trường được trả về theo cơ chế cũ này không bao gồm email, các trường chọn quốc gia, identity_id, address_id, các tham chiếu đến tệp đã tải lên, danh sách giấy tờ chứng minh và trạng thái xác minh. Đây không phải là điểm cuối để tra cứu trạng thái giấy tờ chứng minh hoặc phê duyệt đăng ký. Hãy coi dữ liệu định danh, liên hệ và chữ ký được trả về là thông tin riêng tư.
Không tìm thấy và thử lại
Mã API 404 kèm thông báo Failed, Not found có nghĩa là không tìm thấy hồ sơ đang hoạt động nào khớp với tài khoản và UUID này. Kiểm tra tài khoản, mã định danh và xem hồ sơ đã bị xóa hay chưa. Việc tra cứu này không tiết lộ hồ sơ của tài khoản khác.
Đọc thành công không xác nhận rằng giấy tờ chứng minh đã được chấp nhận hoặc số điện thoại đã được kích hoạt. Nếu bạn đang xử lý lại sau một yêu cầu tạo hoặc đính kèm có kết quả chưa rõ, hãy kiểm tra tài liệu trên cổng thông tin trước khi gửi một yêu cầu khác làm thay đổi trạng thái.