Lataa rekisteröinnin todistustiedostot

Lataa ennen liittämistä

Lataa yhden todistusluokan tai täydentävien asiakirjojen luokan tiedostot ja liitä ne sitten palautettujen tiedostotunnisteiden avulla käyttäen toimintoa create_proof tai create_supporting_document. Pelkkä lataaminen ei luo henkilöllisyystietuetta, osoitetta, todistusta eikä valmista numerorekisteröintiä. Ota lähtökohdaksi ajantasaiset vaatimukset ja luettelotunnisteet.

Anna täsmälleen yksi valitsin: proof_type_id henkilöllisyys- tai osoitetodistusta varten tai supporting_template_id täydentävää asiakirjaa varten. Älä lähetä molempia. Käytä asianomaisen MultiTEL-luettelon palauttamia tunnisteita; käsittele niitä läpinäkymättöminä tunnisteina.

Latauspyyntö

Käytä aktivoitua MultiTEL API -tiliä ja sille sallittua IP-osoitetta. Esimerkeissä HTTP Basic -tunnukset luetaan ympäristömuuttujista; noudata oman tilityyppisi todennuskäytäntöjä. Lähetä pyynnöt HTTPS-yhteydellä. Tarkista sekä HTTP-vastaus että JSON-vastauksen kenttä status.code; sovellusvirheitä voidaan palauttaa myös HTTP 200 -vastauksessa. Alla olevat esimerkit ovat kuvitteellisia.

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

Pyynnön kentät
Kenttä	Merkitys
`files[0] … files[4]`	Yhdestä viiteen ladattavaa tiedostoa. Käytä moniosaista lomakedataa ja anna curlin luoda Content-Type-otsakkeen osaraja. Nämä kentät sisältävät tiedostojen tavut, eivät URL-osoitteita eivätkä JSON Base64 -dataa.
`proof_type_id`	Pakollinen todistusta ladattaessa; käytä palautettua tunnistetta: todistustyypin tunniste. Jätä supporting_template_id pois.
`supporting_template_id`	Pakollinen täydentäville tiedostoille kentän proof_type_id sijaan; käytä palautettua tunnistetta: mallin tunniste.
`description`	Valinnainen kutsujan antama kuvaus, enintään 100 merkkiä. Täydentävää asiakirjaa ladattaessa voidaan käyttää mallin nimeä, jos kuvaus jätetään pois.

Tiedostorajoitukset

Tämä käsittelijä hyväksyy enintään viisi tiedostoa, joiden yhteiskoko on enintään 20,000,000 tavua. Tämä on desimaalinen tavuraja, ei 20 MiB. Infrastruktuuri tai MIME-validointi voi asettaa lisärajoituksia.

Sallitut tiedostopäätteet ovat pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf ja csv. Sallittu tiedostopääte ei osoita, että tiedosto täyttää valitun rekisteröintivaatimuksen. Huomaa erityisesti, että tif ei kuulu sallittujen tiedostopäätteiden luetteloon.

Tarkista jokainen palautettu tiedosto

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

Säilytä jokainen response.ids[].id liittämispyyntöä varten. name ilmaisee palautetun lähdetiedoston nimen. Käytä toisistaan eroavia tiedostonimiä ja vertaa palautettuja tiedostoja odotettuun tiedostojoukkoon: koodi 200 voi tarkoittaa vain osittain onnistunutta erää. Älä liitä tiedostojoukkoa, josta puuttuu pakollisia tiedostoja.

entity_type on identities tai addresses todistukselle ja supporting_documents täydentävän asiakirjan lataukselle. document_category on proof tai supporting. Yleisluonteisesti nimetty vastauskenttä proof_type sisältää myös malliviitteen täydentävien asiakirjojen latauksissa; säilytä alkuperäinen supporting_template_id liittämistä varten.

Liitä viipymättä

Palvelu asettaa vanhenemisajan noin 20 minuutin päähän latauksen paikallisesta tallennuksesta. Liittämisen yhteydessä tarkistetaan, että tiedosto kuuluu samalle tilille, sitä ei ole merkitty vanhentuneeksi, sen vanhenemisaika ei ole vielä kulunut umpeen ja sen entiteettiluokka on oikea. expired_at ei sisällä aikavyöhykepoikkeamaa tässä vastauksessa; älä oleta ajan olevan UTC-aikaa. Liitä tiedostot viipymättä sen sijaan, että ajoittaisit työn aivan vanhenemishetkeen.

Latausviitteen vanheneminen ei ole lupaus siitä, että kaikki tallennetut asiakirjakopiot poistetaan kyseisenä ajankohtana. Palvelu salaa tiedostot operaattorille lataamista varten ja säilyttää lähdetiedostojen tavut asiakirjatyönkulkua varten; älä pidä tätä vain asiakaspuolella tapahtuvana salauksena tai palveluna, joka ei säilytä tietoja. Älä sisällytä tunnisteita, tiedostonimiä tai vastauksia julkisiin lokeihin.

Virheet ja uudelleenyritykset

Nykyinen käsittelijä käyttää API-koodia 404, kun asiakirjatiedostoja ei anneta, ja koodia 500 kuvauksen validointivirheissä, puuttuvien tai ristiriitaisten valitsimien yhteydessä, virheellisten todistustyyppien tai mallien tunnisteiden yhteydessä, tiedostomäärän tai yhteiskoon rajan ylittyessä, tallennusongelmissa tai latauksen epäonnistuessa. Lue status.msg; virheellistä syötettä ei ilmoiteta johdonmukaisesti koodilla 400.

Tässä ei ole käytettävissä asiakkaan idempotenssiavainta. Jos vastaus katoaa, tarkista asiakirjatyönkulku ennen latauksen toistamista; uusi pyyntö voi luoda uusia tiedostoviitteitä. Näitä esimerkkejä ei ole suoritettu asiakkaiden henkilöllisyysasiakirjoilla.