Prieš pridėdami įkelkite
Įkelkite vienos patvirtinimo arba papildomų dokumentų kategorijos failus, tada pridėkite grąžintus failų ID naudodami create_proof arba create_supporting_document. Vien įkėlus failus nesukuriamas nei tapatybės, nei adreso, nei patvirtinimo įrašas ir neužbaigiama numerio registracija. Pradėkite nuo galiojančių reikalavimų ir katalogo ID.
Nurodykite tik vieną parinkties parametrą: proof_type_id tapatybės arba adreso patvirtinimui arba supporting_template_id papildomam dokumentui. Nesiųskite abiejų. Naudokite atitinkamo MultiTEL katalogo grąžintus ID; laikykite juos identifikatoriais, kurių vidinės struktūros nereikia interpretuoti.
Įkėlimo užklausa
Naudokite įgalintą MultiTEL API paskyrą ir jai leidžiamą IP adresą. Pavyzdžiuose HTTP Basic prisijungimo duomenys gaunami iš aplinkos kintamųjų; laikykitės savo paskyros tipui taikomų autentifikavimo taisyklių. Siųskite užklausas per HTTPS. Tikrinkite ir HTTP atsakymą, ir JSON lauką status.code; programos klaidos gali būti grąžinamos su HTTP 200. Toliau pateikti pavyzdžiai yra išgalvoti.
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| Laukas | Reikšmė |
|---|---|
files[0] … files[4] | Nuo vieno iki penkių įkeliamų failų. Naudokite kelių dalių formos duomenis ir leiskite curl sugeneruoti Content-Type dalių skirtuką. Šiuose laukuose pateikiami failų baitai, o ne URL adresai ar Base64 duomenys JSON formatu. |
proof_type_id | Privalomas įkeliant patvirtinimo failus; naudokite grąžintą patvirtinimo tipo ID. Nenurodykite supporting_template_id. |
supporting_template_id | Papildomiems failams privalomas vietoj proof_type_id; naudokite grąžintą šablono ID. |
description | Neprivalomas užklausos siuntėjo pateikiamas aprašas, ne ilgesnis kaip 100 simbolių. Įkeliant papildomus failus, jei aprašas nenurodytas, gali būti naudojamas šablono pavadinimas. |
Failų apribojimai
Ši apdorojimo funkcija priima ne daugiau kaip penkis failus, kurių bendras dydis neviršija 20,000,000 baitų. Tai dešimtainė baitų riba, o ne 20 MiB. Infrastruktūra arba MIME patikra gali nustatyti papildomų apribojimų.
Leidžiami šie failų plėtiniai: pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf ir csv. Leidžiamas plėtinys nepatvirtina, kad failas atitinka pasirinktą registracijos reikalavimą. Atkreipkite dėmesį, kad tif nėra šiame leidžiamų plėtinių sąraše.
Patikrinkite kiekvieną grąžintą failą
{
"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"
}
]
}
}Išsaugokite kiekvieną response.ids[].id pridėjimo užklausai. name nurodo grąžinto pradinio failo pavadinimą. Naudokite skirtingus failų pavadinimus ir palyginkite grąžintus failus su numatytu rinkiniu: kodas 200 gali reikšti, kad failų paketas apdorotas tik iš dalies sėkmingai. Nepridėkite rinkinio, kuriame trūksta privalomų failų.
entity_type reikšmė yra identities arba addresses patvirtinimo failams, o supporting_documents papildomų failų įkėlimui. document_category reikšmė yra proof arba supporting. Bendriniu pavadinimu proof_type pavadintame atsakymo lauke, įkeliant papildomus failus, taip pat pateikiama nuoroda į šabloną; išsaugokite pradinį supporting_template_id pridėjimui.
Pridėkite nedelsdami
Paslauga nustato galiojimo pabaigą maždaug po 20 minučių nuo įkelto failo išsaugojimo vietinėje saugykloje. Pridedant tikrinama, ar failas priklauso tai pačiai paskyrai, ar jis nepažymėtas kaip nebegaliojantis, ar jo galiojimo laikas dar nepasibaigęs ir ar jo objekto kategorija tinkama. expired_at šiame atsakyme neturi laiko juostos poslinkio; nemanykite, kad tai UTC laikas. Pridėkite nedelsdami, o ne planuokite darbą ties galiojimo pabaigos riba.
Įkelto failo nuorodos galiojimo pabaiga negarantuoja, kad tuo metu ištrinamos visos saugomos dokumento kopijos. Paslauga užšifruoja failus, skirtus įkelti ryšio operatoriui, ir išsaugo pradinius baitus dokumentų darbo eigai; nelaikykite to šifravimu tik kliento pusėje ar paslauga, kuri nesaugo duomenų. Neįtraukite ID, failų pavadinimų ir atsakymų į viešus žurnalus.
Klaidos ir pakartotiniai bandymai
Dabartinė apdorojimo funkcija naudoja API kodą 404, kai nepateikta jokių dokumentų failų, ir kodą 500, kai nepavyksta patikrinti aprašo, trūksta parinkties parametrų arba jie prieštarauja vienas kitam, netinkami patvirtinimo tipo ar šablono ID, viršyta failų skaičiaus ar bendro dydžio riba, kyla saugojimo problemų arba įkėlimas nesėkmingas. Perskaitykite status.msg; netinkami įvesties duomenys ne visada žymimi kodu 400.
Čia nenumatytas kliento idempotentiškumo raktas. Jei atsakymas prarandamas, prieš kartodami įkėlimą patikrinkite dokumentų darbo eigą; kita užklausa gali sukurti naujas failų nuorodas. Šie pavyzdžiai nebuvo vykdyti su klientų tapatybės dokumentais.