Liệt kê các loại giấy tờ chứng minh

Chọn loại giấy tờ chứng minh

Sử dụng loại giấy tờ và loại chủ thể được trả về khi chuẩn bị giấy tờ chứng minh cần thiết cho một hồ sơ danh tính. Danh sách này mô tả các loại giấy tờ, không phải các tệp bạn đã tải lên và cũng không thể hiện việc phê duyệt bất kỳ giấy tờ chứng minh nào.

Đáp ứng đúng các yêu cầu thực tế

Việc một loại giấy tờ có trong danh sách không có nghĩa là loại đó đáp ứng yêu cầu của mọi quốc gia, loại số điện thoại hoặc hồ sơ danh tính khách hàng. Hãy đọc các yêu cầu áp dụng trước khi tải giấy tờ chứng minh lên và không suy diễn ý nghĩa hay cấu trúc của các ID được trả về.

Yêu cầu

Sử dụng thông tin xác thực của tài khoản API đã được kích hoạt qua HTTPS. Hỗ trợ xác thực cơ bản (Basic) và mã thông báo mang quyền truy cập (bearer token) của tài khoản API đã được kích hoạt; các hạn chế của tài khoản vẫn áp dụng.

Sử dụng GET với bất kỳ tham số nào được nêu trong tài liệu ở đường dẫn URL.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_proof_types"

Phản hồi

Kiểm tra status.code trong phần thân JSON cùng với trạng thái HTTP. response là một mảng các đối tượng có các trường id, name và entity_type. Các giá trị này lấy từ danh mục giấy tờ chứng minh hiện tại. Không suy diễn ý nghĩa hay cấu trúc của các ID; hãy sao chép chúng thay vì tự tạo hoặc tạo ID bằng hàm băm. Một danh mục trống vẫn có thể được trả về thành công. Không dựa vào ví dụ này để viết cố định một tập giá trị liệt kê đầy đủ cho loại chủ thể.

Cấu trúc phản hồi minh họa; không phải dữ liệu tài khoản thực tế hoặc báo giá hiện tại.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

Lỗi

• Kiểm tra status.code và status.msg để phát hiện lỗi xác thực hoặc lỗi dịch vụ. Việc trả về thành công một danh mục trống không có nghĩa là tài liệu đã được phê duyệt hoặc được miễn đăng ký.

Khả năng sử dụng và tác động phát sinh

• Thao tác tra cứu danh mục/yêu cầu này không tạo hồ sơ danh tính, tải giấy tờ chứng minh lên, đăng ký số điện thoại hoặc đặt hàng.
• Phản hồi danh mục thành công không có nghĩa là giấy tờ của bạn đã được phê duyệt hoặc xác nhận rằng số điện thoại đã chọn có thể được kích hoạt.