Listoni ngarkimet e disponueshme për regjistrim

Listoni referencat e disponueshme të ngarkimeve

Përdoreni këtë pikë fundore pas ngarkimit të dokumenteve të regjistrimit kur duhet të gjeni referenca që janë ende të disponueshme për bashkëngjitje. Përdorni një llogari të aktivizuar MultiTEL API përmes HTTPS, me kredencialet dhe kufizimet IP të konfiguruara për të. Lista kufizohet te llogaria juaj.

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

Nuk kërkohet trup kërkese apo parametra të vargut të kërkimit. Përbërësi i përpunimit liston regjistrimet e ngarkimeve të krijuara përmes API, treguesi i skadimit i të cilave nuk është aktiv dhe koha e skadimit e të cilave është më e vonshme se koha aktuale e serverit. Nuk ofron parametra për faqezim, kërkim apo renditje. Kjo nuk është një listë e të gjitha identiteteve, dëshmive apo dokumenteve historike në llogarinë tuaj.

Lexoni metadatat, jo bajtet e dokumenteve

Lexoni rezultatin HTTP dhe fushën status.code në JSON. Një përgjigje e suksesshme ka një varg në response; një rezultat bosh është një varg bosh, jo një gabim që tregon se llogaria mungon. Shembulli përdor metadata dhe identifikues të trilluar.

{
  "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"
  }]
}

Fushat e metadatave të ngarkimeve
Fusha	Kuptimi
`id`	Referenca e jashtme e ngarkimit. Kopjojeni saktësisht për kërkesën përkatëse të bashkëngjitjes. Mos llogaritni vetë një identifikues dhe mos e zëvendësoni me identifikuesin e një identiteti, adrese apo shablloni.
`proof_type`	Referenca e maskuar e llojit të regjistruar, kur është e pranishme; përndryshe, një varg teksti bosh. Për ngarkimet e dëshmive, kjo është lloji i dëshmisë; ngarkimet e dokumenteve mbështetëse regjistrojnë referencën e shabllonit të tyre nën të njëjtin çelës. Lexoni entity_type për t'i dalluar. Ky nuk është identifikuesi i ngarkimit.
`entity_type`	Kategoria e regjistruar e bashkëngjitjes, si identities, addresses ose supporting_documents. Zgjidhni rrjedhën përkatëse të punës për bashkëngjitje.
`description`	Përshkrimi i ruajtur i ngarkimit.
`file_name`	Emri origjinal i skedarit. Ky nuk është një URL shkarkimi.
`date`	Data dhe ora e regjistruar e krijimit, të formatuara nga serveri pa zhvendosjen e zonës kohore.

Përgjigjja nuk përmban bajte dokumentesh, URL të ruajtjes apo afat skadimi. Ruani expired_at nga përgjigjja fillestare e ngarkimit. Listimi i një ngarkimi nuk ia zgjat vlefshmërinë, nuk e bashkëngjit me një identitet dhe nuk provon se një operator telekomunikacioni e ka miratuar.

Bashkëngjitni përpara se të skadojë referenca

Përdorni rrjedhën përkatëse të punës për bashkëngjitjen e një dëshmie ose bashkëngjitjen e një dokumenti mbështetës. Rrjedha aktuale e punës për ngarkim u jep referencave një periudhë të shkurtër vlefshmërie; mos e vononi bashkëngjitjen vetëm sepse një referencë u shfaq në këtë listë. Një referencë mund të skadojë ose të bëhet e padisponueshme midis listimit dhe bashkëngjitjes. Përpunoni përgjigjen e bashkëngjitjes pa supozuar se veprimi pati sukses.

Nëse lista është bosh në mënyrë të papritur, kontrolloni llogarinë dhe nëse ngarkimi ka skaduar apo është krijuar përmes një rrjedhe tjetër pune. Mos i ngarkoni automatikisht sërish të njëjtat dokumente pa kontrolluar rezultatet fillestare të ngarkimit dhe bashkëngjitjes.

Privatësia

Emrat e skedarëve dhe përshkrimet mund të identifikojnë njerëz apo dokumente edhe pse përmbajtja e skedarëve mungon. Kufizoni aksesin dhe shmangni ruajtjen e përgjigjeve të plota në regjistrat e sistemit. Për të hequr një referencë lokale të papërdorur të një ngarkimi, shihni heqjen e një reference ngarkimi; ai veprim nuk është një shërbim për fshirjen e plotë të dokumenteve.