Ngarkoni përpara se të bashkëngjitni
Ngarkoni skedarët për një kategori të vetme dëshmie ose dokumenti mbështetës, pastaj bashkëngjitni ID-të e skedarëve të kthyera duke përdorur create_proof ose create_supporting_document. Vetëm ngarkimi nuk krijon një identitet, një adresë, një dëshmi apo një regjistrim të përfunduar të numrit. Filloni me kërkesat aktuale dhe ID-të e katalogut.
Jepni saktësisht një parametër përzgjedhjeje: proof_type_id për një dëshmi identiteti/adrese, ose supporting_template_id për një dokument mbështetës. Mos i dërgoni të dy. Përdorni ID-të e kthyera nga katalogu përkatës i MultiTEL; trajtojini si identifikues opakë.
Kërkesa e ngarkimit
Përdorni një llogari API të aktivizuar të MultiTEL dhe adresën IP të lejuar për të. Shembujt përdorin kredenciale HTTP Basic nga variablat e mjedisit; ndiqni rregullat e autentikimit për llojin e llogarisë suaj. Dërgojini kërkesat përmes HTTPS. Kontrolloni si përgjigjen HTTP, ashtu edhe fushën JSON status.code; gabimet e aplikacionit mund të mbërrijnë me HTTP 200. Shembujt më poshtë janë të sajuar.
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| Fusha | Kuptimi |
|---|---|
files[0] … files[4] | Nga një deri në pesë skedarë të ngarkuar. Përdorni të dhëna formulari multipart dhe lëreni curl të gjenerojë ndarësin për Content-Type. Këto fusha përmbajnë bajtet e skedarëve, jo URL apo të dhëna Base64 në JSON. |
proof_type_id | I detyrueshëm për ngarkimin e një dëshmie; përdorni një ID të llojit të dëshmisë të kthyer. Mos përfshini supporting_template_id. |
supporting_template_id | I detyrueshëm në vend të proof_type_id për skedarët mbështetës; përdorni një ID shablloni të kthyer. |
description | Përshkrim opsional i dhënë nga thirrësi, me jo më shumë se 100 karaktere. Ngarkimi i skedarëve mbështetës mund të përdorë emrin e shabllonit kur përshkrimi nuk jepet. |
Kufizimet e skedarëve
Ky përpunues pranon jo më shumë se pesë skedarë dhe 20,000,000 bajte gjithsej. Ky është një kufi bajtesh në sistemin dhjetor, jo 20 MiB. Infrastruktura ose verifikimi MIME mund të vendosë kufizime shtesë.
Lista e prapashtesave të lejuara është pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf dhe csv. Një prapashtesë e lejuar nuk vërteton se skedari përmbush kërkesën e zgjedhur të regjistrimit. Në veçanti, tif nuk është në këtë listë të prapashtesave të lejuara.
Kontrolloni çdo skedar të kthyer
{
"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"
}
]
}
}Ruani çdo response.ids[].id për kërkesën e bashkëngjitjes. name identifikon emrin e skedarit burimor të kthyer. Përdorni emra të ndryshëm skedarësh dhe krahasoni skedarët e kthyer me grupin e pritur: kodi 200 mund të përfaqësojë një grup të përpunuar me sukses vetëm pjesërisht. Mos bashkëngjitni një grup ku mungojnë skedarë të detyrueshëm.
entity_type ka vlerën identities ose addresses për një dëshmi, dhe supporting_documents për një ngarkim skedarësh mbështetës. document_category ka vlerën proof ose supporting. Fusha e përgjigjes me emrin e përgjithshëm proof_type përmban edhe një referencë shablloni për ngarkimet e skedarëve mbështetës; ruani vlerën tuaj fillestare të supporting_template_id për bashkëngjitjen.
Bashkëngjitni pa vonesë
Shërbimi cakton skadimin afërsisht 20 minuta pas ruajtjes lokale të skedarit të ngarkuar. Gjatë bashkëngjitjes kontrollohet që skedari i përket së njëjtës llogari, nuk është shënuar si i skaduar, nuk e ka arritur ende afatin e skadimit dhe ka kategorinë e duhur të entitetit. expired_at nuk ka zhvendosje të zonës kohore në këtë përgjigje; mos supozoni se është në UTC. Bashkëngjitni pa vonesë në vend që ta planifikoni veprimin pikërisht në kufirin e afatit.
Skadimi i referencës së ngarkimit nuk është premtim se të gjitha kopjet e ruajtura të dokumenteve fshihen në atë çast. Shërbimi i enkripton skedarët për ngarkimin te operatori dhe i ruan bajtet burimore për rrjedhën e punës me dokumentet; mos e trajtoni këtë si enkriptim vetëm nga ana e klientit apo si shërbim që nuk ruan të dhëna. Mos i përfshini ID-të, emrat e skedarëve dhe përgjigjet në regjistra publikë.
Gabimet dhe riprovimet
Përpunuesi aktual përdor kodin API 404 kur nuk jepen skedarë dokumentesh dhe kodin 500 për verifikimin e përshkrimit, parametra përzgjedhjeje që mungojnë ose bien ndesh, ID të pavlefshme të llojeve të dëshmive apo shablloneve, kufirin e numrit të skedarëve ose të madhësisë së përgjithshme, probleme ruajtjeje apo një ngarkim të pasuksesshëm. Lexoni status.msg; të dhënat hyrëse të pavlefshme nuk përfaqësohen në mënyrë të njëtrajtshme nga kodi 400.
Këtu nuk vihet në dispozicion asnjë çelës idempotence për klientin. Nëse përgjigjja humbet, kontrolloni rrjedhën e punës me dokumentet përpara se të përsëritni ngarkimin; një kërkesë tjetër mund të krijojë referenca të reja skedarësh. Këta shembuj nuk janë ekzekutuar me dokumente identiteti të klientëve.