Перегляд доступних посилань на завантажені файли
Використовуйте цю кінцеву точку після завантаження реєстраційних документів, коли потрібно знайти посилання, які ще можна використати для прикріплення. Використовуйте активний обліковий запис API MultiTEL через HTTPS із налаштованими для нього обліковими даними та обмеженнями за IP-адресами. Список містить лише записи вашого облікового запису.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesТіло запиту та параметри запиту не потрібні. Обробник повертає записи завантажених файлів, створені через API, у яких прапорець завершення терміну дії не встановлено, а час завершення терміну дії пізніший за поточний час сервера. Параметрів розбиття на сторінки, пошуку чи сортування немає. Це не список усіх записів ідентифікаційних даних, підтверджень або раніше поданих документів у вашому обліковому записі.
Читайте метадані, а не байти документів
Перевірте результат HTTP і поле status.code у JSON. Успішна відповідь містить масив у полі response; порожній результат — це порожній масив, а не помилка відсутності облікового запису. У прикладі використано вигадані метадані та ідентифікатори.
{
"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"
}]
}| Поле | Значення |
|---|---|
id | Зовнішнє посилання на завантажений файл. Скопіюйте його без змін у відповідний запит на прикріплення. Не обчислюйте ідентифікатор самостійно й не підставляйте замість нього ідентифікатор запису ідентифікаційних даних, адреси або шаблону. |
proof_type | Замасковане збережене посилання на тип, якщо воно є; інакше — порожній рядок. Для завантажених підтверджень це тип підтвердження; для завантажених додаткових документів під цим самим ключем зберігається посилання на їхній шаблон. Щоб розрізнити їх, перевірте entity_type. Це не ідентифікатор завантаженого файлу. |
entity_type | Збережена категорія прикріплення, наприклад identities, addresses або supporting_documents. Виберіть відповідний процес прикріплення. |
description | Збережений опис завантаженого файлу. |
file_name | Початкове ім’я файлу. Це не URL-адреса для завантаження файлу. |
date | Збережений час створення, відформатований сервером без зміщення часового поясу. |
Відповідь не містить байтів документів, URL-адреси сховища чи часу завершення терміну дії. Збережіть expired_at з початкової відповіді на завантаження. Поява завантаженого файлу в списку не подовжує термін його дії, не прикріплює його до запису ідентифікаційних даних і не доводить, що оператор зв’язку його схвалив.
Прикріпіть документ до завершення терміну дії посилання
Використовуйте відповідний процес прикріплення підтвердження або прикріплення додаткового документа. У поточному процесі завантаження посилання мають короткий термін дії; не відкладайте прикріплення лише тому, що посилання з’явилося в цьому списку. Між отриманням списку та прикріпленням термін дії посилання може завершитися або воно може стати недоступним. Обробляйте відповідь на прикріплення, а не вважайте дію успішною заздалегідь.
Якщо список несподівано порожній, перевірте обліковий запис, а також чи не завершився термін дії завантаженого файлу та чи не було його завантажено через інший процес. Не завантажуйте ті самі документи повторно автоматично, не перевіривши початкові результати завантаження та прикріплення.
Конфіденційність
Імена файлів та описи можуть дозволити ідентифікувати людей або документи, навіть якщо вміст файлів відсутній. Обмежте доступ і уникайте записування повних відповідей у журнали. Щоб видалити невикористане локальне посилання на завантажений файл, див. видалення посилання на завантажений файл; ця операція не є послугою повного видалення документів.