Lisage isikusamasuse või aadressi tõend

Kasutage seda sammu pärast isiku- või aadressikirje loomist ja selle jaoks nõutavate failide üleslaadimist funktsiooniga create_encrypt_files valitud tõendiliigiga. Kasutage kehtivat tunnust, mille tagastab get_proof_types, ning mis vastab nõudele ja olemi kategooriale.

Säilitage identity_id ja address_id, mille tagastab create_document; profiili UUID on erinev tunnus. Äsja loodud profiilidele aadressitõendi hilisema lisamise ühilduvus on endiselt läbivaatamisel. Kui aadress lükatakse tagasi, kontrollige enne uuesti proovimist portaalis olevat teavet või pöörduge kasutajatoe poole.

Looge tõend

Kasutage aktiveeritud MultiTEL API kontot ja sellele lubatud IP-aadressi. Näidetes kasutatakse keskkonnamuutujatest võetud HTTP Basic autentimisandmeid; järgige oma kontotüübi autentimisreegleid. Saatke päringud protokolli HTTPS kaudu. Kontrollige nii HTTP vastust kui ka JSON välja status.code; rakenduse vead võivad saabuda ka olekukoodiga HTTP 200. Allolevad näited on väljamõeldud.

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

Päringu väljad
Väli	Tähendus
`entity_type`	Kasutage väärtust identities või addresses. Valige kategooria, mis vastab nii sihtolemile kui ka üleslaaditud failidele.
`entity_id`	Teie kontole kuuluva isiku- või aadressikirje tunnus. Kasutage dokumenditöövoo tagastatud tunnust; ärge asendage seda telefoninumbri ega asjassepuutumatu dokumendi tunnusega.
`proof_type_id`	Valitud tõendiliigi tunnus. See peab vastama üleslaadimisel kasutatud liigile ja nõudele.
`encrypted_file_ids`	Mittetühi JSON massiiv failitunnustest, mille tagastab create_encrypt_files. Failid peavad kuuluma samale kontole, nende kehtivusaeg ei tohi olla lõppenud ning need peavad vastama olemi kategooriale. See ei ole kohalike failiteede loend.

Vastu võetakse ka vormiandmeid korduvate encrypted_file_ids[] väljadega. Eelistage tegelikku JSON massiivi või vormimassiivi; ärge saatke JSON vormingus kodeeritud massiivi tavalise skalaarse vormiväärtusena.

Säilitage tõendi tunnus

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

Edukas vastus kinnitab tõendi seose loomist. See ei kinnita isiku- või aadressikirje heakskiitmist, kõigi riigi nõuete täitmise kontrollimist ega telefoninumbri aktiveerimist.

Vead ja aegunud üleslaadimised

API koodi 500 kasutatakse nõutavate sisendandmete puudumise, sideoperaatori tõrgete ja sideoperaatori vigase vastuse korral. Koodi 404 kasutatakse siis, kui sihtolem ei ole seotud praeguse kontoga, tõendiliik on kehtetu, üleslaaditud faili ei leita selle konto või kategooria alt või fail on aegunud või kui ühtegi kasutatavat failitunnust pole alles. Lugege välja status.msg koos koodiga.

Laadige aegunud nõutav fail enne selle lisamist uuesti üles, kasutades õiget tõendikategooriat. Kui mõni esitatud fail on kehtetu, peatub see päringutöötleja enne tõendi loomise päringu saatmist. Idempotentsusvõtit ei ole saadaval: pärast ajalõppu kontrollige enne lisamise kordamist portaalis olemasolevat dokumenti.