Izstrādātājiem

GET/v3/get_encrypted_files

Pieejamo reģistrācijas dokumentu augšupielāžu saraksts

Atrodiet API augšupielāžu atsauces, kuru derīguma termiņš nav beidzies, un metadatus pirms reģistrācijas dokumentu pievienošanas.

Šajā lapā
  1. Pieejamo augšupielāžu atsauču saraksts
  2. Lasiet metadatus, nevis dokumentu baitus
  3. Pievienojiet pirms atsauces derīguma termiņa beigām
  4. Privātums

Pieejamo augšupielāžu atsauču saraksts

Izmantojiet šo galapunktu pēc reģistrācijas dokumentu augšupielādes gadījumos, kad jāatrod atsauces, kuras joprojām var izmantot pievienošanai. Izmantojiet iespējotu MultiTEL API kontu, izveidojot savienojumu ar HTTPS un ievērojot kontam konfigurētos autentifikācijas datus un IP ierobežojumus. Saraksts attiecas tikai uz jūsu kontu.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/get_encrypted_files

Nav nepieciešams ne pieprasījuma pamatteksts, ne vaicājuma parametri. Apstrādātājs uzskaita ar API izveidotos augšupielāžu ierakstus, kuriem nav iestatīts derīguma termiņa beigu karodziņš un kuru derīguma termiņš ir vēlāks par servera pašreizējo laiku. Tas nepiedāvā lapošanas, meklēšanas vai kārtošanas parametrus. Tas nav visu jūsu kontā esošo identitāšu, apliecinājumu vai vēsturisko dokumentu saraksts.

Lasiet metadatus, nevis dokumentu baitus

Pārbaudiet HTTP rezultātu un JSON lauku status.code. Veiksmīgas atbildes laukā response ir masīvs; tukšs rezultāts ir tukšs masīvs, nevis kļūda par neesošu kontu. Piemērā izmantoti izdomāti metadati un identifikatori.

{
  "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"
  }]
}
Augšupielādes metadatu lauki
LauksNozīme
idĀrējā augšupielādes atsauce. Precīzi nokopējiet to attiecīgajam pievienošanas pieprasījumam. Neaprēķiniet identifikatoru pats un neaizstājiet to ar identitātes, adreses vai veidnes identifikatoru.
proof_typeMaskēta saglabātā tipa atsauce, ja tā ir norādīta; pretējā gadījumā — tukša virkne. Apliecinājumu augšupielādēm tas ir apliecinājuma tips; papildu dokumentu augšupielādēm ar šo pašu atslēgu tiek saglabāta veidnes atsauce. Lai tās atšķirtu, pārbaudiet lauku entity_type. Tas nav augšupielādes identifikators.
entity_typeSaglabātā pievienošanas kategorija, piemēram, identities, addresses vai supporting_documents. Izvēlieties atbilstošo pievienošanas darbplūsmu.
descriptionSaglabātais augšupielādes apraksts.
file_nameSākotnējais faila nosaukums. Tas nav lejupielādes URL.
dateSaglabātais izveides laiks, ko serveris formatējis bez laika joslas nobīdes.

Atbildē nav dokumentu baitu, glabāšanas vietas URL vai derīguma termiņa. Saglabājiet expired_at no sākotnējās augšupielādes atbildes. Augšupielādes iekļaušana sarakstā nepagarina tās derīgumu, nepievieno to identitātei un neapliecina, ka sakaru operators to ir apstiprinājis.

Pievienojiet pirms atsauces derīguma termiņa beigām

Izmantojiet atbilstošo apliecinājuma pievienošanas vai papildu dokumenta pievienošanas darbplūsmu. Pašreizējā augšupielādes darbplūsmā atsaucēm ir īss derīguma periods; neatlieciet pievienošanu tikai tāpēc, ka atsauce ir parādījusies šajā sarakstā. Laikā starp saraksta iegūšanu un pievienošanu atsauces derīguma termiņš var beigties vai tā var kļūt nepieejama. Apstrādājiet pievienošanas atbildi, nevis pieņemiet, ka darbība ir izdevusies.

Ja saraksts negaidīti ir tukšs, pārbaudiet kontu un to, vai augšupielādes derīguma termiņš nav beidzies vai tā nav izveidota citā darbplūsmā. Neaugšupielādējiet tos pašus dokumentus automātiski vēlreiz, pirms neesat pārbaudījis sākotnējās augšupielādes un pievienošanas rezultātus.

Privātums

Failu nosaukumi un apraksti var ļaut identificēt personas vai dokumentus, lai gan failu saturs nav iekļauts. Ierobežojiet piekļuvi un izvairieties no pilnu atbilžu ierakstīšanas žurnālos. Lai noņemtu neizmantotu lokālu augšupielādes atsauci, skatiet norādi augšupielādes atsauces noņemšana; šī darbība nav visaptverošs dokumentu dzēšanas pakalpojums.