Pridėkite tapatybę arba adresą patvirtinantį dokumentą

Atlikite šį veiksmą, kai tapatybė arba adresas jau sukurti ir reikiami failai įkelti naudojant create_encrypt_files su pasirinktu patvirtinamojo dokumento tipu. Naudokite galiojantį identifikatorių, gautą iš get_proof_types, atitinkantį reikalavimą ir objekto kategoriją.

Išsaugokite identity_id ir address_id, gautus iš create_document; profilio UUID yra kitas identifikatorius. Vis dar tikrinama, ar prie naujai sukurtų profilių galima vėliau pridėti adresą patvirtinantį dokumentą. Jei adresas atmetamas, prieš bandydami dar kartą patikrinkite informaciją portale arba kreipkitės į pagalbos tarnybą.

Sukurkite patvirtinamojo dokumento sąsają

Naudokite įjungtą MultiTEL API paskyrą ir jai leidžiamą IP adresą. Pavyzdžiuose naudojami HTTP Basic prisijungimo duomenys 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" \
  --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"
  ]
}

Užklausos laukai
Laukas	Reikšmė
`entity_type`	Naudokite identities arba addresses. Pasirinkite kategoriją, atitinkančią ir objektą, su kuriuo siejate dokumentą, ir įkeltus failus.
`entity_id`	Jūsų paskyrai priklausančios tapatybės arba adreso identifikatorius. Naudokite dokumentų tvarkymo proceso grąžintą identifikatorių; nekeiskite jo telefono numeriu ar nesusijusio dokumento identifikatoriumi.
`proof_type_id`	Pasirinkto patvirtinamojo dokumento tipo identifikatorius. Jis turi atitikti įkeliant pasirinktą tipą ir reikalavimą.
`encrypted_file_ids`	Netuščias JSON masyvas su failų identifikatoriais, kuriuos grąžino create_encrypt_files. Failai turi priklausyti tai pačiai paskyrai, jų galiojimas turi būti nepasibaigęs ir jie turi atitikti objekto kategoriją. Tai nėra vietinių failų kelių sąrašas.

Taip pat priimami formos duomenys su pasikartojančiais encrypted_file_ids[] laukais. Rinkitės tikrą JSON masyvą arba formos masyvą; nesiųskite JSON formatu užkoduoto masyvo kaip įprastos skaliarinės formos reikšmės.

Išsaugokite patvirtinamojo dokumento identifikatorių

{
  "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"
  }
}

Sėkmingas atsakymas patvirtina, kad patvirtinamojo dokumento sąsaja sukurta. Jis nepatvirtina, kad tapatybė ar adresas patvirtinti, kad patikrinta atitiktis visiems šalies reikalavimams arba kad telefono numeris aktyvintas.

Klaidos ir įkelti failai, kurių galiojimas pasibaigęs

API kodas 500 naudojamas, kai trūksta privalomų įvesties duomenų, įvyksta ryšio operatoriaus klaidų arba gaunamas netinkamas operatoriaus atsakymas. Kodas 404 naudojamas, kai objektas nesusietas su dabartine paskyra, patvirtinamojo dokumento tipas netinkamas, įkelto failo nepavyksta rasti šiai paskyrai ar kategorijai arba jo galiojimas pasibaigęs, arba nelieka tinkamų naudoti failų identifikatorių. Skaitykite status.msg kartu su kodu.

Prieš pridėdami privalomą failą, kurio galiojimas pasibaigęs, įkelkite jį iš naujo pasirinkę tinkamą patvirtinamojo dokumento kategoriją. Jei kuris nors pateiktas failas netinkamas, šis užklausų apdorojimo komponentas sustabdo vykdymą prieš išsiųsdamas patvirtinamojo dokumento sąsajos kūrimo užklausą. Idempotentiškumo raktas nepateikiamas: pasibaigus atsakymo laukimo laikui, prieš kartodami pridėjimą patikrinkite esamą dokumentą portale.