Списък на наличните препратки към качени файлове
Използвайте тази крайна точка след качване на документи за регистрация, когато трябва да намерите препратки, които все още могат да се използват за прикачване. Използвайте активиран MultiTEL API акаунт през HTTPS с конфигурираните за него данни за достъп и ограничения по IP адрес. Списъкът е ограничен до вашия акаунт.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesНе се изискват тяло на заявката или параметри на заявката в URL адреса. Обработващата функция извежда записите за качени файлове, създадени чрез 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 от първоначалния отговор при качването. Показването на качен файл в списъка не удължава валидността му, не го прикачва към самоличност и не доказва, че оператор го е одобрил.
Прикачете файла, преди да изтече валидността на препратката
Използвайте подходящия работен процес за прикачване на доказателство или прикачване на придружаващ документ. При текущия работен процес за качване препратките имат кратък срок на валидност; не отлагайте прикачването само защото дадена препратка се е появила в този списък. Валидността на препратката може да изтече или тя да стане недостъпна между показването в списъка и прикачването. Обработете отговора на заявката за прикачване, вместо да приемате, че тя е успешна.
Ако списъкът е неочаквано празен, проверете акаунта и дали валидността на качения файл е изтекла или той е качен чрез друг работен процес. Не качвайте автоматично същите документи отново, без да проверите първоначалните резултати от качването и прикачването.
Поверителност
Имената на файловете и описанията могат да разкрият самоличността на хора или да идентифицират документи, въпреки че съдържанието на файловете липсва. Ограничете достъпа и избягвайте записването на цели отговори в журналите. За да премахнете неизползвана локална препратка към качен файл, вижте премахване на препратка към качен файл; тази операция не е услуга за цялостно изтриване на документи.