Pievienojiet identitātes vai adreses apliecinājumu

Izmantojiet šo darbību pēc identitātes vai adreses izveides un tai nepieciešamo failu augšupielādes, izmantojot create_encrypt_files ar izvēlēto apliecinājuma veidu. Izmantojiet aktuālu identifikatoru, ko atgriež get_proof_types, kas atbilst prasībai un entītijas kategorijai.

Saglabājiet identity_id un address_id, ko atgriež create_document; profila UUID ir cits identifikators. Iespēja vēlāk pievienot adreses apliecinājumu jaunizveidotiem profiliem joprojām tiek pārbaudīta. Ja adrese tiek noraidīta, pirms atkārtota mēģinājuma pārbaudiet informāciju portālā vai sazinieties ar atbalsta dienestu.

Izveidojiet apliecinājumu

Izmantojiet aktivizētu 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; lietojumprogrammas kļūdas var tikt saņemtas arī ar HTTP 200. Tālāk sniegtie piemēri ir izdomāti.

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

Pieprasījuma lauki
Lauks	Nozīme
`entity_type`	Izmantojiet identities vai addresses. Izvēlieties kategoriju, kas atbilst gan mērķa entītijai, gan augšupielādētajiem failiem.
`entity_id`	Jūsu kontam piederošās identitātes vai adreses identifikators. Izmantojiet dokumentu darbplūsmas atgriezto identifikatoru; neaizstājiet to ar tālruņa numuru vai nesaistīta dokumenta identifikatoru.
`proof_type_id`	Izvēlētā apliecinājuma veida identifikators. Tam jāatbilst augšupielādei un prasībai.
`encrypted_file_ids`	Netukšs JSON masīvs ar failu identifikatoriem, ko atgriež create_encrypt_files. Failiem jāpieder tam pašam kontam, to derīguma termiņš nedrīkst būt beidzies, un tiem jāatbilst entītijas kategorijai. Tas nav lokālo failu ceļu saraksts.

Tiek pieņemti arī veidlapas dati ar atkārtotiem encrypted_file_ids[] laukiem. Dodiet priekšroku īstam JSON masīvam vai veidlapas masīvam; nesūtiet JSON formātā kodētu masīvu kā parastu skalāru veidlapas vērtību.

Saglabājiet apliecinājuma identifikatoru

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

Veiksmīga atbilde apstiprina apliecinājuma piesaistes izveidi. Tā neapstiprina identitātes vai adreses apstiprināšanu, visu valsts prasību izpildes pārbaudi vai tālruņa numura aktivizēšanu.

Kļūdas un augšupielādes ar beigušos derīguma termiņu

API kods 500 tiek izmantots, ja trūkst obligāto ievaddatu, rodas sakaru operatora kļūmes vai saņemta nederīga operatora atbilde. Kods 404 tiek izmantots, ja mērķa entītija nav saistīta ar pašreizējo kontu, apliecinājuma veids nav derīgs, augšupielādētais fails nav atrodams šim kontam vai kategorijai vai tā derīguma termiņš ir beidzies, vai nav palicis neviens izmantojams faila identifikators. Izlasiet status.msg kopā ar kodu.

Pirms pievienošanas atkārtoti augšupielādējiet nepieciešamo failu, kura derīguma termiņš ir beidzies, izmantojot pareizo apliecinājuma kategoriju. Ja kāds no iesniegtajiem failiem nav derīgs, šis apstrādātājs pārtrauc darbību pirms apliecinājuma izveides pieprasījuma nosūtīšanas. Idempotences atslēga nav pieejama: pēc noildzes pārbaudiet esošo dokumentu portālā, pirms atkārtojat pievienošanu.