Programeri

GET/v3/get_encrypted_files

Popis dostupnih prijenosa registracijskih dokumenata

Pronađite reference na prijenose putem API-ja koje nisu istekle i njihove metapodatke prije prilaganja registracijskih dokumenata.

Na ovoj stranici
  1. Popis dostupnih referenci na prijenose
  2. Čitajte metapodatke, a ne bajtove dokumenta
  3. Priložite prije isteka reference
  4. Privatnost

Popis dostupnih referenci na prijenose

Upotrijebite ovu krajnju točku nakon prijenosa registracijskih dokumenata kada trebate pronaći reference koje su još dostupne za prilaganje. Koristite aktiviran MultiTEL račun za API putem protokola HTTPS, s njegovim konfiguriranim vjerodajnicama i IP ograničenjima. Popis je ograničen na vaš račun.

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

Nisu potrebni tijelo zahtjeva ni parametri upita. Obrađivač zahtjeva prikazuje zapise o prijenosima stvorene putem API-ja čija zastavica isteka nije postavljena i čije je vrijeme isteka kasnije od trenutačnog vremena poslužitelja. Ne nudi parametre za podjelu na stranice, pretraživanje ni sortiranje. To nije popis svih identiteta, dokaza ili povijesnih dokumenata na vašem računu.

Čitajte metapodatke, a ne bajtove dokumenta

Pročitajte rezultat HTTP-a i status.code u odgovoru u formatu JSON. Uspješan odgovor sadrži polje u response; prazan rezultat jest prazno polje, a ne pogreška zbog nepostojećeg računa. U primjeru se koriste izmišljeni metapodaci i 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"
  }]
}
Polja metapodataka o prijenosu
PoljeZnačenje
idVanjska referenca na prijenos. Kopirajte je točno u odgovarajući zahtjev za prilaganje. Nemojte sami izračunavati identifikator niti umjesto njega upotrebljavati ID identiteta, adrese ili predloška.
proof_typeMaskirana zabilježena referenca na vrstu, ako postoji, a inače prazan niz znakova. Za prijenose dokaza to je vrsta dokaza; pri prijenosu popratnih dokumenata referenca na njihov predložak bilježi se pod istim ključem. Pročitajte entity_type kako biste ih razlikovali. To nije ID prijenosa.
entity_typeZabilježena kategorija prilaganja, kao što su identities, addresses ili supporting_documents. Odaberite odgovarajući tijek rada za prilaganje.
descriptionPohranjeni opis prijenosa.
file_nameIzvorni naziv datoteke. To nije URL za preuzimanje.
dateZabilježeno vrijeme stvaranja, koje poslužitelj oblikuje bez pomaka vremenske zone.

Odgovor ne sadrži bajtove dokumenta, URL mjesta pohrane ni rok isteka. Sačuvajte expired_at iz izvornog odgovora na prijenos. Prikaz prijenosa na popisu ne produljuje njegovu valjanost, ne prilaže ga identitetu niti dokazuje da ga je telekomunikacijski operator odobrio.

Priložite prije isteka reference

Upotrijebite odgovarajući tijek rada za prilaganje dokaza ili prilaganje popratnog dokumenta. U trenutačnom tijeku rada za prijenos reference imaju kratko razdoblje valjanosti; nemojte odgađati prilaganje samo zato što se referenca pojavila na ovom popisu. Referenca može isteći ili postati nedostupna između prikaza na popisu i prilaganja. Obradite odgovor na zahtjev za prilaganje umjesto da pretpostavite da je uspio.

Ako je popis neočekivano prazan, provjerite račun i je li prijenos istekao ili je stvoren putem drugog tijeka rada. Nemojte automatski ponovno prenositi iste dokumente bez provjere rezultata izvornog prijenosa i prilaganja.

Privatnost

Nazivi datoteka i opisi mogu otkriti identitet osoba ili dokumenata iako sadržaj datoteka nije prisutan. Ograničite pristup i izbjegavajte bilježenje cijelih odgovora u zapisnike. Za uklanjanje neiskorištene lokalne reference na prijenos pogledajte uklanjanje reference na prijenos; ta operacija nije usluga za sveobuhvatno brisanje dokumenata.