Bashkëngjitni një dokument vërtetues të identitetit ose adresës

Kryeni këtë hap pasi identiteti ose adresa të ekzistojë dhe pasi të keni ngarkuar skedarët e nevojshëm përmes create_encrypt_files me llojin e përzgjedhur të dokumentit vërtetues. Përdorni një identifikues aktual nga get_proof_types, që përputhet me kërkesën dhe kategorinë e entitetit.

Ruani identity_id dhe address_id nga create_document; identifikuesi UUID i profilit është i ndryshëm. Përputhshmëria e bashkëngjitjes së mëvonshme të dokumenteve vërtetuese të adresës për profilet e sapokrijuara është ende në shqyrtim. Nëse adresa refuzohet, kontrolloni portalin ose kontaktoni shërbimin e mbështetjes përpara se të provoni përsëri.

Krijoni dokumentin vërtetues

Përdorni një llogari API MultiTEL të aktivizuar dhe adresën IP të lejuar për të. Shembujt përdorin kredenciale HTTP Basic nga variablat e mjedisit; ndiqni konventat e autentikimit për llojin e llogarisë suaj. Dërgojini kërkesat përmes HTTPS. Kontrolloni si përgjigjen HTTP, ashtu edhe fushën në JSON status.code; gabimet e aplikacionit mund të kthehen me HTTP 200. Shembujt e mëposhtëm janë të trilluar.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Fushat e kërkesës
Fusha	Kuptimi
`entity_type`	Përdorni identities ose addresses. Zgjidhni kategorinë që përputhet si me entitetin e synuar, ashtu edhe me skedarët e ngarkuar.
`entity_id`	Identifikuesi i identitetit ose adresës që i përket llogarisë suaj. Përdorni identifikuesin e kthyer nga rrjedha juaj e punës për dokumentet; mos e zëvendësoni me një numër telefoni ose me identifikuesin e një dokumenti që nuk ka lidhje.
`proof_type_id`	Identifikuesi i llojit të përzgjedhur të dokumentit vërtetues. Sigurohuni që ai të përputhet me ngarkimin dhe kërkesën.
`encrypted_file_ids`	Varg JSON jo bosh me identifikues skedarësh të kthyer nga create_encrypt_files. Skedarët duhet t'i përkasin së njëjtës llogari, të mos kenë skaduar dhe të përputhen me kategorinë e entitetit. Kjo nuk është një listë shtigjesh të skedarëve lokalë.

Pranohen edhe të dhëna formulari me përsëritje të fushave encrypted_file_ids[] në formular. Preferoni një varg të mirëfilltë JSON ose një varg formulari; mos dërgoni një varg të koduar në JSON si një vlerë të zakonshme skalare të formularit.

Ruani identifikuesin e dokumentit vërtetues

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Një përgjigje e suksesshme konfirmon krijimin e lidhjes së dokumentit vërtetues. Ajo nuk konfirmon miratimin e identitetit/adresës, verifikimin e përmbushjes së të gjitha kërkesave të vendit apo aktivizimin e një numri telefoni.

Gabimet dhe skedarët e ngarkuar që kanë skaduar

Kodi API 500 përdoret kur mungojnë të dhëna hyrëse të detyrueshme, kur ka dështime të operatorit dhe kur përgjigjja e operatorit është e pavlefshme. Kodi 404 përdoret kur entiteti i synuar nuk është i lidhur me llogarinë aktuale, lloji i dokumentit vërtetues është i pavlefshëm, një skedar i ngarkuar nuk mund të gjendet për këtë llogari/kategori ose ka skaduar, ose nuk mbetet asnjë identifikues skedari i përdorshëm. Lexoni status.msg së bashku me kodin.

Ngarkoni përsëri një skedar të detyrueshëm që ka skaduar, duke përdorur kategorinë e duhur të dokumentit vërtetues, përpara se ta bashkëngjitni. Nëse ndonjë nga skedarët e dhënë është i pavlefshëm, ky trajtues ndalet përpara se të dërgojë kërkesën për krijimin e dokumentit vërtetues. Nuk vihet në dispozicion asnjë çelës idempotence: pas tejkalimit të afatit të pritjes, kontrolloni dokumentin ekzistues në portal përpara se të përsëritni bashkëngjitjen.