Laadige failid üles enne lisamist
Laadige üles ühe tõendus- või lisadokumendi kategooria failid ning seejärel lisage tagastatud faili-ID-d, kasutades create_proof või create_supporting_document. Üleslaadimine üksi ei loo isiku-, aadressi- ega tõenduskirjet ega vii numbri registreerimist lõpule. Alustuseks vaadake üle kehtivad nõuded ja kataloogide ID-d.
Esitage täpselt üks valikuparameeter: proof_type_id isiku või aadressi tõendamiseks või supporting_template_id lisadokumendi jaoks. Ärge saatke mõlemat. Kasutage vastavast MultiTEL-i kataloogist tagastatud ID-sid; käsitlege neid identifikaatoritena, mille sisestruktuurile ei tohi tähendust omistada.
Üleslaadimispäring
Kasutage lubatud MultiTEL-i API kontot ja sellele lubatud IP-aadressi. Näidetes kasutatakse keskkonnamuutujatest pärinevaid HTTP Basic autentimisandmeid; järgige oma kontotüübi autentimistavasid. Saatke päringud HTTPS-i kaudu. Kontrollige nii HTTP-vastust kui ka JSON-välja status.code; rakenduse vead võivad saabuda HTTP 200 vastusega. Allolevad näited on väljamõeldud.
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| Väli | Tähendus |
|---|---|
files[0] … files[4] | Üks kuni viis üleslaaditavat faili. Kasutage mitmeosalisi vormiandmeid ja laske curl-il genereerida Content-Type osade eraldaja. Need väljad sisaldavad faili baite, mitte URL-e ega JSON Base64 andmeid. |
proof_type_id | Kohustuslik tõendusfaili üleslaadimisel; kasutage tagastatud tõenditüübi ID-d. Jätke supporting_template_id välja. |
supporting_template_id | Lisadokumendi failide puhul kohustuslik parameetri proof_type_id asemel; kasutage tagastatud malli ID-d. |
description | Valikuline päringu tegija esitatud kirjeldus, kuni 100 märki. Lisadokumendi üleslaadimisel saab kirjelduse puudumisel kasutada malli nime. |
Failide piirangud
See töötleja võtab vastu kuni viis faili kogumahuga kuni 20,000,000 baiti. See on kümnendsüsteemis baitide piirang, mitte 20 MiB. Taristu või MIME valideerimine võib kehtestada lisapiiranguid.
Lubatud faililaiendid on pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf ja csv. Lubatud faililaiend ei tõenda, et fail vastab valitud registreerimisnõudele. Pange tähele, et tif ei kuulu sellesse lubatud laiendite loendisse.
Kontrollige iga tagastatud faili
{
"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äilitage iga response.ids[].id väärtus lisamispäringu jaoks. name näitab tagastatud lähtefaili nime. Kasutage erinevaid failinimesid ja võrrelge tagastatud faile oodatud komplektiga: kood 200 võib tähendada, et failikomplekti töötlemine õnnestus osaliselt. Ärge lisage komplekti, millest puuduvad nõutud failid.
entity_type on identities või addresses tõendusfaili korral ning supporting_documents lisadokumendi üleslaadimise korral. document_category on proof või supporting. Üldise nimega vastuseväli proof_type sisaldab lisadokumendi üleslaadimisel ka viidet mallile; säilitage lisamise jaoks algne supporting_template_id.
Lisage failid viivitamata
Teenus määrab aegumisaja ligikaudu 20 minutiks pärast üleslaaditud faili kohalikku salvestamist. Lisamisel kontrollitakse, et fail kuulub samale kontole, ei ole märgitud aegunuks, selle aegumisaeg ei ole veel saabunud ja sellel on õige olemikategooria. expired_at ei sisalda selles vastuses ajavööndi nihet; ärge eeldage, et see on UTC-aeg. Lisage failid viivitamata, selle asemel et ajastada toiming aegumisaja piirile.
Üleslaadimisviite aegumine ei taga, et kõik salvestatud dokumendikoopiad kustutatakse sel ajal. Teenus krüpteerib failid sideoperaatorile üleslaadimiseks ja säilitab lähtebaidid dokumentide töövoo jaoks; ärge käsitlege seda ainult kliendipoolse krüpteerimise või andmeid mittesäilitava teenusena. Ärge lisage ID-sid, failinimesid ega vastuseid avalikesse logidesse.
Vead ja korduskatsed
Praegune töötleja kasutab API koodi 404, kui dokumendifaile pole esitatud, ning koodi 500 kirjelduse valideerimisvigade, puuduvate või vastuoluliste valikuparameetrite, vigaste tõenditüübi või malli ID-de, failide arvu või kogumahu piirangu ületamise, salvestusprobleemide või ebaõnnestunud üleslaadimise korral. Lugege välja status.msg; vigast sisendit ei tähistata alati koodiga 400.
Siin ei ole kliendi idempotentsusvõti saadaval. Kui vastus läheb kaotsi, kontrollige enne üleslaadimise kordamist dokumentide töövoogu; uus päring võib luua uued failiviited. Neid näiteid ei ole käivitatud klientide isikut tõendavate dokumentidega.