Đính kèm giấy tờ chứng minh danh tính hoặc địa chỉ

Thực hiện bước này sau khi danh tính hoặc địa chỉ đã được tạo và các tệp bắt buộc tương ứng đã được tải lên qua create_encrypt_files với loại giấy tờ chứng minh đã chọn. Sử dụng mã định danh hiện hành lấy từ get_proof_types, phù hợp với yêu cầu và loại thực thể.

Lưu lại identity_id và address_id từ create_document; UUID của hồ sơ là một mã khác. Khả năng đính kèm giấy tờ chứng minh địa chỉ ở bước sau cho các hồ sơ mới tạo vẫn đang được xem xét. Nếu địa chỉ bị từ chối, hãy kiểm tra trên cổng thông tin hoặc liên hệ bộ phận hỗ trợ trước khi thử lại.

Tạo bản ghi giấy tờ chứng minh

Sử dụng tài khoản API MultiTEL đã được kích hoạt và địa chỉ IP được cho phép của tài khoản đó. Các ví dụ sử dụng thông tin xác thực HTTP Basic từ các 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 lẫn trường sau trong JSON: status.code; lỗi ứng dụng có thể được trả về cùng với HTTP 200. Các ví dụ dưới đây là giả định.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Các trường của yêu cầu
Trường	Ý nghĩa
`entity_type`	Sử dụng identities hoặc addresses. Chọn loại phù hợp với cả đối tượng đích và các tệp đã tải lên.
`entity_id`	Mã định danh của danh tính hoặc địa chỉ thuộc tài khoản của bạn. Sử dụng mã định danh được trả về từ quy trình xử lý tài liệu của bạn; không thay bằng số điện thoại hoặc mã định danh của tài liệu không liên quan.
`proof_type_id`	Mã định danh của loại giấy tờ chứng minh đã chọn. Đảm bảo mã này nhất quán với thông tin khi tải lên và với yêu cầu.
`encrypted_file_ids`	Mảng JSON không rỗng chứa các mã định danh tệp do create_encrypt_files trả về. Các tệp phải thuộc cùng một tài khoản, chưa hết hạn và phù hợp với loại thực thể. Đây không phải là danh sách đường dẫn tệp cục bộ.

Dữ liệu biểu mẫu cũng được chấp nhận khi lặp lại trường encrypted_file_ids[] nhiều lần. Ưu tiên sử dụng mảng JSON thực sự hoặc mảng trong biểu mẫu; không gửi mảng được mã hóa theo JSON dưới dạng giá trị vô hướng thông thường của biểu mẫu.

Lưu lại mã định danh của giấy tờ chứng minh

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Phản hồi thành công xác nhận rằng liên kết với giấy tờ chứng minh đã được tạo. Phản hồi này không xác nhận danh tính/địa chỉ đã được phê duyệt, tất cả yêu cầu của quốc gia đã được kiểm tra và đáp ứng, hay số điện thoại đã được kích hoạt.

Lỗi và tệp tải lên đã hết hạn

Mã API 500 được sử dụng khi thiếu dữ liệu đầu vào bắt buộc, xảy ra lỗi từ nhà mạng hoặc phản hồi của nhà mạng không hợp lệ. Mã 404 được sử dụng khi đối tượng đích không liên kết với tài khoản hiện tại, loại giấy tờ chứng minh không hợp lệ, không tìm thấy tệp đã tải lên cho tài khoản/loại này hoặc tệp đã hết hạn, hay không còn mã định danh tệp nào có thể sử dụng. Hãy đọc status.msg cùng với mã lỗi.

Tải lại tệp bắt buộc đã hết hạn với đúng loại giấy tờ chứng minh trước khi đính kèm. Nếu bất kỳ tệp nào được cung cấp không hợp lệ, trình xử lý này sẽ dừng trước khi gửi yêu cầu tạo bản ghi giấy tờ chứng minh. Không có khóa chống xử lý lặp được cung cấp: sau khi yêu cầu hết thời gian chờ, hãy kiểm tra tài liệu hiện có trên cổng thông tin trước khi thực hiện lại thao tác đính kèm.