Peržiūrėti galimas įkeltų failų nuorodas
Naudokite šį galinį tašką po registracijos dokumentų įkėlimo veiksmų, kai reikia rasti nuorodas, kurias vis dar galima naudoti pridedant dokumentus. Naudokite aktyvią „MultiTEL“ API paskyrą per HTTPS, laikydamiesi jai nustatytų prisijungimo duomenų ir IP adresų apribojimų. Sąraše pateikiami tik jūsų paskyros įrašai.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesUžklausos turinys ir užklausos parametrai nereikalingi. Užklausos apdorojimo procedūra pateikia per API sukurtus įkeltų failų įrašus, kurių pasibaigusio galiojimo žyma nenustatyta ir kurių galiojimo pabaigos laikas yra vėlesnis už dabartinį serverio laiką. Puslapiavimo, paieškos ar rikiavimo parametrų nėra. Tai nėra visų jūsų paskyros tapatybės įrašų, patvirtinamųjų dokumentų ar anksčiau pateiktų dokumentų sąrašas.
Skaitykite metaduomenis, o ne dokumentų baitus
Patikrinkite HTTP rezultatą ir JSON lauką status.code. Sėkmingo atsakymo lauke response pateikiamas masyvas; tuščias rezultatas yra tuščias masyvas, o ne klaida dėl nerastos paskyros. Pavyzdyje naudojami išgalvoti metaduomenys ir identifikatoriai.
{
"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"
}]
}| Laukas | Reikšmė |
|---|---|
id | Išorinė įkelto failo nuoroda. Tiksliai nukopijuokite ją į atitinkamą dokumento pridėjimo užklausą. Neskaičiuokite identifikatoriaus patys ir nekeiskite jo tapatybės įrašo, adreso ar šablono identifikatoriumi. |
proof_type | Užmaskuota įrašyta tipo nuoroda, jei ji yra; kitu atveju – tuščia eilutė. Įkeltų patvirtinamųjų dokumentų atveju tai yra patvirtinimo tipas; įkeltų papildomų dokumentų šablono nuoroda įrašoma tuo pačiu raktu. Norėdami juos atskirti, patikrinkite entity_type. Tai nėra įkelto failo identifikatorius. |
entity_type | Įrašyta pridedamo dokumento kategorija, pavyzdžiui, identities, addresses arba supporting_documents. Pasirinkite atitinkamą dokumento pridėjimo procesą. |
description | Išsaugotas įkelto failo aprašymas. |
file_name | Pradinis failo pavadinimas. Tai nėra atsisiuntimo URL adresas. |
date | Įrašytas sukūrimo laikas, kurį serveris suformatavo be laiko juostos poslinkio. |
Atsakyme nėra dokumentų baitų, saugojimo vietos URL adreso ar galiojimo pabaigos laiko. Išsaugokite expired_at iš pradinio įkėlimo atsakymo. Įkelto failo pateikimas sąraše nepratęsia jo galiojimo, neprideda jo prie tapatybės įrašo ir neįrodo, kad ryšio operatorius jį patvirtino.
Pridėkite dokumentą, kol nuorodos galiojimas nepasibaigė
Naudokite atitinkamą patvirtinamojo dokumento pridėjimo arba papildomo dokumento pridėjimo procesą. Dabartiniame įkėlimo procese nuorodos galioja trumpai; neatidėliokite dokumento pridėjimo vien todėl, kad nuoroda pasirodė šiame sąraše. Nuo sąrašo gavimo iki dokumento pridėjimo nuorodos galiojimas gali pasibaigti arba ji gali tapti nepasiekiama. Apdorokite dokumento pridėjimo atsakymą, o ne iš anksto laikykite veiksmą sėkmingu.
Jei sąrašas netikėtai tuščias, patikrinkite paskyrą ir ar įkelto failo galiojimas nepasibaigė arba ar jis nebuvo įkeltas kitu procesu. Automatiškai neįkelkite tų pačių dokumentų dar kartą, nepatikrinę pradinio įkėlimo ir dokumento pridėjimo rezultatų.
Privatumas
Failų pavadinimai ir aprašymai gali atskleisti asmenų tapatybę ar leisti atpažinti dokumentus, nors failų turinio nėra. Apribokite prieigą ir venkite žurnaluose įrašyti visus atsakymus. Norėdami pašalinti nenaudojamą vietinę įkelto failo nuorodą, žr. įkelto failo nuorodos pašalinimą; ši operacija nėra visapusiško dokumentų ištrynimo paslauga.