Listați încărcările disponibile pentru înregistrare

Listați referințele disponibile ale încărcărilor

Utilizați acest punct de acces după încărcarea documentelor de înregistrare atunci când trebuie să găsiți referințe care sunt încă disponibile pentru atașare. Utilizați un cont MultiTEL API activat, prin HTTPS, cu datele de autentificare și restricțiile IP configurate pentru acesta. Lista se limitează la contul dumneavoastră.

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

Nu sunt necesare un corp al cererii sau parametri de interogare. Componenta de procesare listează înregistrările încărcărilor create prin API al căror indicator de expirare nu este setat și a căror dată de expirare este ulterioară momentului curent al serverului. Nu oferă parametri de paginare, căutare sau sortare. Aceasta nu este o listă a tuturor identităților, dovezilor sau documentelor din istoricul contului dumneavoastră.

Citiți metadatele, nu octeții documentelor

Citiți rezultatul HTTP și câmpul status.code din JSON. Un răspuns reușit conține un tablou în response; un rezultat gol este un tablou gol, nu o eroare care indică lipsa contului. Exemplul folosește metadate și identificatori fictivi.

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

Câmpurile metadatelor încărcărilor
Câmp	Semnificație
`id`	Referința externă a încărcării. Copiați-o exact pentru cererea de atașare corespunzătoare. Nu calculați singur un identificator și nu o înlocuiți cu identificatorul unei identități, al unei adrese sau al unui șablon.
`proof_type`	Referința mascată a tipului înregistrat, dacă există; în caz contrar, un șir gol. Pentru încărcările de dovezi, aceasta reprezintă tipul dovezii; încărcările de documente justificative își înregistrează referința șablonului sub aceeași cheie. Citiți entity_type pentru a le deosebi. Acesta nu este identificatorul încărcării.
`entity_type`	Categoria de atașare înregistrată, precum identities, addresses sau supporting_documents. Alegeți fluxul de atașare corespunzător.
`description`	Descrierea stocată a încărcării.
`file_name`	Numele original al fișierului. Acesta nu este un URL de descărcare.
`date`	Data și ora creării înregistrate, formatate de server fără un decalaj de fus orar.

Răspunsul nu conține octeții documentelor, un URL de stocare sau termenul de expirare. Păstrați expired_at din răspunsul inițial la încărcare. Listarea unei încărcări nu îi prelungește valabilitatea, nu o atașează unei identități și nu dovedește că un operator de telecomunicații a aprobat-o.

Atașați înainte de expirarea referinței

Utilizați fluxul corespunzător pentru atașarea unei dovezi sau atașarea unui document justificativ. Fluxul actual de încărcare acordă referințelor o perioadă scurtă de valabilitate; nu amânați atașarea doar pentru că o referință a apărut în această listă. O referință poate expira sau poate deveni indisponibilă între listare și atașare. Tratați răspunsul la atașare fără a presupune că operațiunea a reușit.

Dacă lista este goală în mod neașteptat, verificați contul și dacă încărcarea a expirat sau a fost creată printr-un alt flux. Nu încărcați automat aceleași documente din nou fără a verifica rezultatele inițiale ale încărcării și atașării.

Confidențialitate

Numele fișierelor și descrierile pot identifica persoane sau documente chiar dacă lipsește conținutul fișierelor. Limitați accesul și evitați înregistrarea răspunsurilor complete în jurnale. Pentru a elimina o referință locală neutilizată a unei încărcări, consultați eliminarea unei referințe de încărcare; operațiunea respectivă nu este un serviciu de ștergere completă a documentelor.