Regisztrációs igazoló fájlok feltöltése

Csatolás előtt töltse fel a fájlokat

Töltse fel az egy igazolási vagy kiegészítő dokumentumkategóriához tartozó fájlokat, majd csatolja a visszakapott fájlazonosítókat az alábbi műveletek egyikével: create_proof vagy create_supporting_document. A feltöltés önmagában nem hoz létre személyazonosságot, címet, igazolást vagy befejezett telefonszám-regisztrációt. Kiindulásként tekintse át az aktuális követelmények listáját és a katalógusazonosítókat.

Pontosan egy kiválasztó mezőt adjon meg: proof_type_id személyazonosságot vagy címet igazoló dokumentumhoz, vagy supporting_template_id kiegészítő dokumentumhoz. Ne küldje el mindkettőt. A megfelelő MultiTEL-katalógus által visszaadott azonosítókat használja; kezelje őket belső jelentés nélküli azonosítóként.

Feltöltési kérés

Használjon engedélyezett MultiTEL API-fiókot és a hozzá engedélyezett IP-címet. A példák környezeti változókból származó HTTP Basic hitelesítési adatokat használnak; kövesse a fióktípusára vonatkozó hitelesítési szabályokat. A kéréseket HTTPS-en keresztül küldje. Ellenőrizze a HTTP-választ és a JSON következő mezőjét is: status.code; alkalmazáshibák HTTP 200 válasszal is érkezhetnek. Az alábbi példák kitaláltak.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

A kérés mezői
Mező	Jelentés
`files[0] … files[4]`	Egy–öt feltöltött fájl. Használjon többrészes űrlapadatokat, és bízza a curl programra a Content-Type határolójának előállítását. Ezek a mezők a fájlok bájtjait tartalmazzák, nem URL-eket vagy JSON Base64-adatokat.
`proof_type_id`	Igazolás feltöltésekor kötelező; használjon egy visszakapott azonosítót a következő típusból: igazolástípus-azonosító. Hagyja ki a supporting_template_id mezőt.
`supporting_template_id`	Kiegészítő fájloknál a proof_type_id helyett kötelező; használjon egy visszakapott azonosítót a következő típusból: sablonazonosító.
`description`	A hívó által megadható, legfeljebb 100 karakteres leírás. Kiegészítő dokumentum feltöltésekor a leírás elhagyása esetén a sablon neve használható.

Fájlkorlátok

Ez a kéréskezelő legfeljebb öt fájlt fogad el, összesen legfeljebb 20,000,000 bájt méretben. Ez tízes számrendszer szerinti bájtkorlát, nem 20 MiB. Az infrastruktúra vagy a MIME-ellenőrzés további korlátokat szabhat.

Az engedélyezett kiterjesztések: pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf és csv. Az engedélyezett kiterjesztés nem bizonyítja, hogy a fájl megfelel a kiválasztott regisztrációs követelménynek. Külön kiemelendő, hogy a tif nem szerepel az engedélyezett kiterjesztések listáján.

Ellenőrizzen minden visszakapott fájlt

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

Őrizze meg minden fájlhoz a response.ids[].id értékét a csatolási kéréshez. A name a visszaadott eredeti fájlnevet azonosítja. Használjon egymástól különböző fájlneveket, és hasonlítsa össze a visszakapott fájlokat a várt készlettel: a 200 kód részben sikeres kötegelt műveletet is jelezhet. Ne csatoljon olyan készletet, amelyből kötelező fájlok hiányoznak.

entity_type értéke identities vagy addresses igazolás esetén, illetve supporting_documents kiegészítő dokumentum feltöltésekor. A document_category értéke proof vagy supporting. Az általános elnevezésű proof_type válaszmező kiegészítő dokumentumok feltöltésekor sablonhivatkozást is tartalmaz; a csatoláshoz őrizze meg az eredeti supporting_template_id értékét.

Mielőbb csatolja a fájlokat

A szolgáltatás a feltöltés helyi tárolásától számítva körülbelül 20 perces lejárati időt állít be. Csatoláskor ellenőrzi, hogy a fájl ugyanahhoz a fiókhoz tartozik-e, nincs-e lejártként megjelölve, nem telt-e még le az érvényessége, és megfelelő-e az entitáskategóriája. Az expired_at ebben a válaszban nem tartalmaz időzóna-eltolást; ne feltételezze, hogy UTC szerinti időpont. Mielőbb végezze el a csatolást, ne a lejárat határára időzítse a műveletet.

A feltöltési hivatkozás lejárata nem jelent ígéretet arra, hogy az összes tárolt dokumentumpéldányt akkor törlik. A szolgáltatás titkosítja a fájlokat a távközlési szolgáltatóhoz történő feltöltéshez, és megőrzi az eredeti bájtokat a dokumentumkezelési munkafolyamathoz; ne tekintse ezt kizárólag kliensoldali titkosításnak vagy adatmegőrzés nélküli szolgáltatásnak. Az azonosítók, fájlnevek és válaszok ne kerüljenek nyilvános naplókba.

Hibák és újrapróbálkozások

A jelenlegi kéréskezelő 404 API-kódot használ, ha nem adtak meg dokumentumfájlokat, és 500 kódot a leírás ellenőrzésekor fellépő hibák, hiányzó vagy egymásnak ellentmondó kiválasztó mezők, érvénytelen igazolás- vagy sablonazonosítók, a fájlszám- vagy összméretkorlát túllépése, tárolási problémák vagy sikertelen feltöltés esetén. Olvassa el a következő mezőt: status.msg; az érvénytelen bemenetet nem minden esetben a 400 kód jelzi.

Itt nem áll rendelkezésre kliensoldali idempotenciakulcs. Ha a válasz elvész, a feltöltés megismétlése előtt ellenőrizze a dokumentumkezelési munkafolyamatot; egy újabb kérés új fájlhivatkozásokat hozhat létre. Ezeket a példákat nem futtatták ügyfelek személyazonosító dokumentumaival.