Prenesite datoteke s dokazima za registraciju

Prenesite prije prilaganja

Prenesite datoteke za jednu kategoriju dokaza ili popratnih dokumenata, a zatim priložite vraćene ID-ove datoteka pomoću create_proof ili create_supporting_document. Samim prijenosom ne stvara se identitet, adresa, dokaz ni dovršena registracija broja. Kao polazište upotrijebite aktualne zahtjeve i ID-ove iz kataloga.

Navedite točno jedan parametar odabira: proof_type_id za dokaz identiteta/adrese ili supporting_template_id za popratni dokument. Nemojte slati oba. Upotrijebite ID-ove koje vraća odgovarajući katalog MultiTEL-a; tretirajte ih kao identifikatore čiji se sadržaj ne tumači.

Zahtjev za prijenos

Upotrijebite omogućen račun za MultiTEL API i IP adresu dopuštenu za taj račun. Primjeri upotrebljavaju vjerodajnice za HTTP Basic iz varijabli okruženja; slijedite pravila autentifikacije za svoju vrstu računa. Šaljite zahtjeve putem HTTPS-a. Provjerite i HTTP odgovor i JSON polje status.code; pogreške aplikacije mogu stići uz HTTP 200. Primjeri u nastavku su izmišljeni.

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

Polja zahtjeva
Polje	Značenje
`files[0] … files[4]`	Od jedne do pet prenesenih datoteka. Upotrijebite višedijelne podatke obrasca i prepustite curlu da generira razdjelnik u zaglavlju Content-Type. Ta polja sadrže bajtove datoteka, a ne URL-ove ni JSON Base64.
`proof_type_id`	Obavezno za prijenos dokaza; upotrijebite vraćeni ID vrste dokaza. Izostavite supporting_template_id.
`supporting_template_id`	Obavezno umjesto proof_type_id za popratne datoteke; upotrijebite vraćeni ID predloška.
`description`	Neobavezan opis koji navodi pozivatelj, najviše 100 znakova. Pri prijenosu popratnih datoteka može se upotrijebiti naziv predloška ako je opis izostavljen.

Ograničenja datoteka

Ova funkcija za obradu prihvaća najviše pet datoteka i ukupno 20,000,000 bajtova. To je decimalno ograničenje u bajtovima, a ne 20 MiB. Infrastruktura ili provjera MIME vrste mogu nametnuti dodatna ograničenja.

Dopušteni datotečni nastavci su pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf i csv. Dopušten nastavak ne potvrđuje da datoteka ispunjava odabrani zahtjev za registraciju. Posebno napominjemo da tif nije na ovom popisu dopuštenih nastavaka.

Provjerite svaku vraćenu datoteku

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

Sačuvajte svaki response.ids[].id za zahtjev za prilaganje. name označava vraćeni naziv izvorne datoteke. Upotrijebite različite nazive datoteka i usporedite vraćene datoteke s očekivanim skupom: kod 200 može označavati djelomično uspješnu skupnu obradu. Nemojte priložiti skup u kojem nedostaju obavezne datoteke.

entity_type ima vrijednost identities ili addresses za dokaz, a supporting_documents za prijenos popratnih datoteka. document_category ima vrijednost proof ili supporting. Polje odgovora s općenitim nazivom proof_type također sadrži referencu na predložak za prijenose popratnih datoteka; sačuvajte svoj izvorni supporting_template_id za prilaganje.

Priložite što prije

Usluga postavlja istek na približno 20 minuta nakon lokalne pohrane prenesenih datoteka. Pri prilaganju provjerava se pripada li datoteka istom računu, nije li označena kao istekla, je li još uvijek prije isteka i ima li ispravnu kategoriju entiteta. expired_at u ovom odgovoru nema pomak vremenske zone; nemojte pretpostaviti da je u UTC-u. Priložite datoteke što prije umjesto da zakazujete rad neposredno uz trenutak isteka.

Istek reference na prenesenu datoteku nije jamstvo da se u tom trenutku brišu sve pohranjene kopije dokumenta. Usluga šifrira datoteke za prijenos telekomunikacijskom operatoru i zadržava izvorne bajtove za tijek obrade dokumenata; nemojte to smatrati šifriranjem isključivo na strani klijenta ni uslugom koja ne zadržava podatke. ID-ove, nazive datoteka i odgovore nemojte bilježiti u javne zapisnike.

Pogreške i ponovni pokušaji

Trenutačna funkcija za obradu upotrebljava API kod 404 kada nisu dostavljene datoteke dokumenata, a kod 500 za provjeru valjanosti opisa, nedostajuće ili proturječne parametre odabira, nevaljane ID-ove dokaza ili predložaka, ograničenje broja datoteka ili ukupne veličine, probleme s pohranom ili neuspješan prijenos. Pročitajte status.msg; nevaljan unos nije dosljedno označen kodom 400.

Ovdje klijentu nije dostupan ključ idempotentnosti. Ako se odgovor izgubi, provjerite tijek obrade dokumenata prije ponavljanja prijenosa; dodatni zahtjev može stvoriti nove reference na datoteke. Ovi primjeri nisu izvršeni s identifikacijskim dokumentima klijenata.