Приказ доступних референци на отпремљене датотеке
Користите ову крајњу тачку након отпремања докумената за регистрацију када треба да пронађете референце које су и даље доступне за прилагање. Користите омогућен MultiTEL API налог преко протокола HTTPS, са подешеним приступним подацима и ограничењима IP адреса. Списак је ограничен на ваш налог.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesНису потребни тело захтева ни параметри упита. Обрађивач приказује записе о отпремљеним датотекама направљене преко API-ја код којих ознака истека није постављена и чије је време истека касније од тренутног времена сервера. Нису доступни параметри за поделу на странице, претрагу или сортирање. Ово није списак свих идентитета, доказа или ранијих докумената на вашем налогу.
Читајте метаподатке, а не бајтове докумената
Прочитајте HTTP резултат и, у JSON одговору, поље status.code. Успешан одговор садржи низ у пољу 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 из првобитног одговора на отпремање. Приказивање отпремљене датотеке на списку не продужава њену важност, не прилаже је идентитету нити доказује да ју је оператер одобрио.
Приложите датотеку пре истека важности референце
Користите одговарајући поступак за прилагање доказа или прилагање пратећег документа. У тренутном поступку отпремања референце имају кратак рок важности; немојте одлагати прилагање само зато што се референца појавила на овом списку. Референци може истећи важност или она може постати недоступна између приказивања на списку и прилагања. Обрадите одговор на прилагање уместо да претпоставите да је оно успело.
Ако је списак неочекивано празан, проверите налог и да ли је отпремљеној датотеци истекла важност или је отпремљена другим поступком. Немојте аутоматски поново отпремати исте документе без провере првобитних резултата отпремања и прилагања.
Приватност
Називи датотека и описи могу открити идентитет особа или докумената иако садржај датотека није присутан. Ограничите приступ и избегавајте бележење целих одговора у евиденцији. За уклањање неискоришћене локалне референце на отпремљену датотеку погледајте уклањање референце на отпремљену датотеку; та операција није услуга за свеобухватно брисање докумената.