Получение списка доступных загрузок регистрационных документов

Получение списка доступных ссылок на загрузки

Используйте эту конечную точку после загрузки регистрационных документов, если нужно найти ссылки, которые ещё можно использовать для прикрепления. Используйте активированную учётную запись MultiTEL API с подключением по 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 из исходного ответа на загрузку. Наличие загрузки в списке не продлевает срок её действия, не прикрепляет её к удостоверению личности и не подтверждает, что оператор связи её одобрил.

Прикрепите документ до истечения срока действия ссылки

Используйте соответствующий процесс прикрепления подтверждающего документа или прикрепления сопроводительного документа. В текущем процессе загрузки ссылки имеют короткий срок действия; не откладывайте прикрепление лишь потому, что ссылка появилась в этом списке. Между получением списка и прикреплением срок действия ссылки может истечь или ссылка может стать недоступной. Обрабатывайте ответ на запрос прикрепления, а не считайте операцию успешной заранее.

Если список неожиданно оказался пустым, проверьте учётную запись, а также не истёк ли срок действия загрузки и не была ли она создана с помощью другого процесса. Не загружайте те же документы повторно автоматически, не проверив результаты исходной загрузки и прикрепления.

Конфиденциальность

Имена файлов и описания могут позволить идентифицировать людей или документы, даже если содержимое файлов отсутствует. Ограничьте доступ и избегайте записи полных ответов в журналы. Чтобы удалить неиспользуемую локальную ссылку на загрузку, см. раздел «Удаление ссылки на загрузку»; эта операция не обеспечивает полное удаление документов.