Listaa käytettävissä olevat latausviitteet
Kun rekisteröintiasiakirjojen lataaminen on valmis, käytä tätä päätepistettä, jos tarvitset viitteitä, joita voi edelleen käyttää asiakirjojen liittämiseen. Käytä aktivoitua MultiTEL-API-tiliä HTTPS-yhteydellä sekä tilille määritettyjä tunnistetietoja ja IP-rajoituksia. Luettelo koskee vain omaa tiliäsi.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesPyynnön runkoa tai kyselyparametreja ei tarvita. Käsittelijä listaa API:n kautta luodut lataustietueet, joiden vanhentumismerkintää ei ole asetettu ja joiden vanhenemisaika on palvelimen nykyhetken jälkeen. Se ei tarjoa sivutus-, haku- tai lajitteluparametreja. Tämä ei ole luettelo tilisi kaikista henkilöllisyystietueista, todistuksista tai aiemmista asiakirjoista.
Lue metatietoja, älä asiakirjan tavuja
Lue HTTP-tulos ja JSON-vastauksen status.code-kenttä. Onnistuneen vastauksen response-kentässä on taulukko; tyhjä tulos on tyhjä taulukko, ei puuttuvasta tilistä kertova virhe. Esimerkissä käytetään kuvitteellisia metatietoja ja tunnisteita.
{
"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"
}]
}| Kenttä | Merkitys |
|---|---|
id | Latauksen ulkoinen viite. Kopioi se täsmälleen kyseiseen liittämispyyntöön. Älä laske tunnistetta itse äläkä korvaa sitä henkilöllisyystietueen, osoitteen tai mallin tunnisteella. |
proof_type | Tallennettu tyyppiviite peitetyssä muodossa, jos se on olemassa, muutoin tyhjä merkkijono. Todistuslatauksissa tämä on todistuksen tyyppi; täydentävien asiakirjojen latauksissa malliviite tallennetaan samalla avaimella. Erota ne toisistaan lukemalla entity_type-kenttä. Tämä ei ole latauksen tunniste. |
entity_type | Tallennettu liittämisluokka, kuten identities, addresses tai supporting_documents. Valitse sitä vastaava liittämistyönkulku. |
description | Latauksen tallennettu kuvaus. |
file_name | Alkuperäinen tiedostonimi. Tämä ei ole tiedoston latausosoite. |
date | Tallennettu luontiaika palvelimen muotoilemana ilman aikavyöhykepoikkeamaa. |
Vastaus ei sisällä asiakirjan tavuja, tallennusosoitetta eikä vanhenemisajankohtaa. Säilytä alkuperäisen latausvastauksen expired_at-arvo. Latauksen näkyminen luettelossa ei pidennä sen voimassaoloa, liitä sitä henkilöllisyystietueeseen eikä osoita, että operaattori olisi hyväksynyt sen.
Liitä asiakirja ennen viitteen vanhenemista
Käytä tilanteeseen sopivaa työnkulkua: todistuksen liittäminen tai täydentävän asiakirjan liittäminen. Nykyisessä lataustyönkulussa viitteiden voimassaoloaika on lyhyt; älä lykkää liittämistä vain siksi, että viite näkyi tässä luettelossa. Viite voi vanhentua tai poistua käytöstä luetteloinnin ja liittämisen välillä. Käsittele liittämispyynnön vastaus sen sijaan, että olettaisit liittämisen onnistuneen.
Jos luettelo on odottamatta tyhjä, tarkista tili sekä se, onko lataus vanhentunut tai luotu toisessa työnkulussa. Älä lataa samoja asiakirjoja automaattisesti uudelleen tarkistamatta alkuperäisen latauksen ja liittämisen tuloksia.
Tietosuoja
Tiedostonimet ja kuvaukset voivat paljastaa henkilön tai asiakirjan, vaikka tiedostojen sisältö puuttuu. Rajoita käyttöoikeuksia ja vältä kokonaisten vastausten tallentamista lokiin. Käyttämättömän paikallisen latausviitteen poistamiseksi katso latausviitteen poistaminen; kyseinen toiminto ei ole kattava asiakirjojen poistopalvelu.