Az elérhető regisztrációs feltöltések listázása

Az elérhető feltöltési hivatkozások listázása

Ezt a végpontot a regisztrációs dokumentumok feltöltése után használja, ha olyan hivatkozásokat szeretne keresni, amelyek még felhasználhatók csatoláshoz. Használjon engedélyezett MultiTEL API-fiókot HTTPS-kapcsolaton keresztül, a fiókhoz beállított hitelesítési adatokkal és IP-korlátozásokkal. A lista kizárólag az Ön fiókjára terjed ki.

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

Nincs szükség kéréstörzsre vagy lekérdezési paraméterekre. A kéréskezelő az API által létrehozott azon feltöltési rekordokat listázza, amelyeknél a lejáratot jelző jelző nincs beállítva, és amelyek lejárati ideje későbbi a kiszolgáló aktuális idejénél. Nem biztosít lapozási, keresési vagy rendezési paramétereket. Ez nem a fiókhoz tartozó összes személyazonosság, igazolás vagy korábbi dokumentum listája.

Metaadatok lekérése a dokumentum bájtjai helyett

Olvassa ki a HTTP eredményét és a JSON-válasz status.code mezőjét. Sikeres válasz esetén a response mező egy tömböt tartalmaz; az üres eredmény üres tömb, nem pedig hiányzó fiókot jelző hiba. A példában szereplő metaadatok és azonosítók kitaláltak.

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

A feltöltés metaadatmezői
Mező	Jelentés
`id`	A feltöltés külső hivatkozása. Pontosan másolja át a megfelelő csatolási kérésbe. Ne számítson ki saját maga azonosítót, és ne helyettesítse személyazonosság-, cím- vagy sablonazonosítóval.
`proof_type`	A rögzített típushivatkozás maszkolt értéke, ha van ilyen; egyébként üres karakterlánc. Igazolásfeltöltéseknél ez az igazolás típusa; az alátámasztó dokumentumok feltöltései ugyanezen kulcs alatt rögzítik a sablonhivatkozásukat. Megkülönböztetésükhöz olvassa ki az entity_type mezőt. Ez nem a feltöltés azonosítója.
`entity_type`	A rögzített csatolási kategória, például identities, addresses vagy supporting_documents. Válassza a megfelelő csatolási munkafolyamatot.
`description`	A feltöltés tárolt leírása.
`file_name`	Az eredeti fájlnév. Ez nem letöltési URL.
`date`	A rögzített létrehozási idő, a kiszolgáló által formázva, időzóna-eltolás nélkül.

A válasz nem tartalmazza a dokumentum bájtjait, tárolási URL-t vagy lejárati határidőt. Őrizze meg az eredeti feltöltési válasz expired_at értékét. Egy feltöltés listázása nem hosszabbítja meg annak érvényességét, nem csatolja személyazonossághoz, és nem bizonyítja, hogy egy távközlési szolgáltató jóváhagyta.

Csatolás a hivatkozás lejárata előtt

Használja a megfelelő igazoláscsatolási vagy alátámasztó dokumentum csatolására szolgáló munkafolyamatot. A jelenlegi feltöltési munkafolyamatban a hivatkozások csak rövid ideig érvényesek; ne halassza el a csatolást pusztán azért, mert egy hivatkozás megjelent ezen a listán. A listázás és a csatolás között a hivatkozás lejárhat vagy elérhetetlenné válhat. Dolgozza fel a csatolási választ, ne feltételezze a művelet sikerességét.

Ha a lista váratlanul üres, ellenőrizze a fiókot, valamint azt, hogy a feltöltés lejárt-e, vagy másik munkafolyamatban hozták-e létre. Ne töltse fel automatikusan újra ugyanazokat a dokumentumokat az eredeti feltöltés és csatolás eredményeinek ellenőrzése nélkül.

Adatvédelem

A fájlnevek és leírások akkor is azonosíthatnak személyeket vagy dokumentumokat, ha a fájlok tartalma nincs jelen. Korlátozza a hozzáférést, és kerülje a teljes válaszok naplózását. Egy fel nem használt helyi feltöltési hivatkozás eltávolításához lásd: feltöltési hivatkozás eltávolítása; ez a művelet nem nyújt teljes körű dokumentumtörlési szolgáltatást.