Pirms pievienošanas augšupielādējiet
Augšupielādējiet vienas apliecinājuma vai papilddokumenta kategorijas failus, pēc tam pievienojiet atgrieztos failu ID, izmantojot create_proof vai create_supporting_document. Augšupielāde pati par sevi neizveido identitāti, adresi vai apliecinājumu un nepabeidz numura reģistrāciju. Vispirms iepazīstieties ar aktuālajām prasībām un katalogu ID.
Norādiet tieši vienu atlases parametru: proof_type_id identitātes vai adreses apliecinājumam vai supporting_template_id papilddokumentam. Nesūtiet abus. Izmantojiet attiecīgā MultiTEL kataloga atgrieztos ID; uztveriet tos kā identifikatorus, kuru iekšējai struktūrai nav jāpiešķir nozīme.
Augšupielādes pieprasījums
Izmantojiet iespējotu MultiTEL API kontu un tam atļauto IP adresi. Piemēros tiek izmantoti HTTP Basic autentifikācijas dati no vides mainīgajiem; ievērojiet sava konta veida autentifikācijas noteikumus. Sūtiet pieprasījumus, izmantojot HTTPS. Pārbaudiet gan HTTP atbildi, gan JSON lauku status.code; lietotnes kļūdas var tikt atgrieztas ar HTTP 200. Tālāk sniegtie piemēri ir izdomāti.
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| Lauks | Nozīme |
|---|---|
files[0] … files[4] | No viena līdz pieciem augšupielādētiem failiem. Izmantojiet vairāku daļu veidlapas datus un ļaujiet curl ģenerēt Content-Type daļu atdalītāju. Šajos laukos ir failu baiti, nevis URL vai JSON Base64 dati. |
proof_type_id | Obligāts apliecinājuma augšupielādei; izmantojiet atgriezto apliecinājuma veida ID. Nenorādiet supporting_template_id. |
supporting_template_id | Papilddokumentu failiem obligāts parametra proof_type_id vietā; izmantojiet atgriezto veidnes ID. |
description | Neobligāts pieprasījuma sūtītāja norādīts apraksts, ne garāks par 100 rakstzīmēm. Ja apraksts nav norādīts, papilddokumenta augšupielādei var izmantot veidnes nosaukumu. |
Failu ierobežojumi
Šis apstrādātājs pieņem ne vairāk kā piecus failus, kuru kopējais lielums nepārsniedz 20,000,000 baitu. Tas ir baitu ierobežojums decimālajā sistēmā, nevis 20 MiB. Infrastruktūra vai MIME validācija var noteikt papildu ierobežojumus.
Atļauto paplašinājumu saraksts ir pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf un csv. Atļauts paplašinājums neapliecina, ka fails atbilst atlasītajai reģistrācijas prasībai. Ņemiet vērā, ka tif nav šajā atļauto paplašinājumu sarakstā.
Pārbaudiet katru atgriezto failu
{
"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"
}
]
}
}Saglabājiet katru response.ids[].id vērtību pievienošanas pieprasījumam. name norāda atgrieztā avota faila nosaukumu. Izmantojiet atšķirīgus failu nosaukumus un salīdziniet atgrieztos failus ar sagaidāmo kopu: kods 200 var nozīmēt, ka failu kopas apstrāde izdevusies tikai daļēji. Nepievienojiet kopu, kurā trūkst obligāto failu.
entity_type ir identities vai addresses apliecinājumam un supporting_documents papilddokumenta augšupielādei. document_category ir proof vai supporting. Vispārīgi nosauktais atbildes lauks proof_type papilddokumentu augšupielādēm satur arī atsauci uz veidni; pievienošanai saglabājiet sākotnējo supporting_template_id.
Pievienojiet bez kavēšanās
Pakalpojums nosaka derīguma termiņu aptuveni 20 minūtes pēc augšupielādētā faila lokālas saglabāšanas. Pievienošanas laikā tiek pārbaudīts, vai fails pieder tam pašam kontam, nav atzīmēts kā nederīgs termiņa beigšanās dēļ, tā derīguma termiņš vēl nav beidzies un tam ir pareizā entītijas kategorija. expired_at šajā atbildē nesatur laika joslas nobīdi; nepieņemiet, ka tas ir UTC laiks. Pievienojiet bez kavēšanās, nevis ieplānojiet darbu uz derīguma termiņa beigām.
Augšupielādes atsauces derīguma termiņa beigas negarantē, ka tajā brīdī tiek dzēstas visas saglabātās dokumenta kopijas. Pakalpojums šifrē failus augšupielādei operatoram un saglabā avota baitus dokumentu darbplūsmai; neuzskatiet to par šifrēšanu tikai klienta pusē vai pakalpojumu bez datu saglabāšanas. Neiekļaujiet ID, failu nosaukumus un atbildes publiskos žurnālos.
Kļūdas un atkārtoti mēģinājumi
Pašreizējais apstrādātājs izmanto API kodu 404, ja nav iesniegti dokumentu faili, un kodu 500 apraksta validācijas kļūdu, trūkstošu vai savstarpēji konfliktējošu atlases parametru, nederīgu apliecinājuma vai veidnes ID, failu skaita vai kopējā lieluma ierobežojuma pārsniegšanas, glabāšanas problēmu vai neveiksmīgas augšupielādes gadījumā. Izlasiet status.msg; nederīga ievade ne vienmēr tiek norādīta ar kodu 400.
Šeit nav pieejama klienta idempotences atslēga. Ja atbilde pazūd, pirms augšupielādes atkārtošanas pārbaudiet dokumentu darbplūsmu; vēl viens pieprasījums var izveidot jaunas failu atsauces. Šie piemēri nav izpildīti ar klientu identitātes dokumentiem.