Személyazonosságot vagy lakcímet igazoló dokumentum csatolása

Ezt a lépést akkor használja, ha a személyazonosság vagy a lakcím már létezik, és a szükséges fájlokat már feltöltötte a következővel: create_encrypt_files, a kiválasztott igazolástípussal. Használjon aktuális azonosítót a következőből: get_proof_types, a követelménynek és az entitáskategóriának megfelelően.

Őrizze meg az identity_id és address_id értékét, amelyeket a következő ad vissza: create_document; a profil UUID azonosítója ettől eltér. Még vizsgálják, hogy az újonnan létrehozott profilokhoz később kompatibilisen csatolható-e lakcímigazolás. Ha a lakcímet elutasítják, az újrapróbálkozás előtt ellenőrizze a portált, vagy kérjen segítséget az ügyfélszolgálattól.

Az igazolás létrehozása

Használjon engedélyezett MultiTEL API-fiókot és a hozzá engedélyezett IP-címet. A példák környezeti változókból származó HTTP Basic hitelesítő adatokat használnak; kövesse a fióktípusára vonatkozó hitelesítési szabályokat. A kéréseket HTTPS protokollon küldje. Ellenőrizze a HTTP-választ és a JSON következő mezőjét is: status.code; alkalmazásszintű hibák HTTP 200 válasz mellett is előfordulhatnak. Az alábbi példák kitalált adatokat tartalmaznak.

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

A kérés mezői
Mező	Jelentés
`entity_type`	Használja az identities vagy az addresses értéket. Olyan kategóriát válasszon, amely mind a célként megadott entitásnak, mind a feltöltött fájloknak megfelel.
`entity_id`	A fiókjához tartozó személyazonosság vagy lakcím azonosítója. A dokumentumkezelési munkafolyamat által visszaadott azonosítót használja; ne helyettesítse telefonszámmal vagy egy nem kapcsolódó dokumentum azonosítójával.
`proof_type_id`	A kiválasztott igazolástípus azonosítója. Ügyeljen arra, hogy megfeleljen a feltöltésnél használt típusnak és a követelménynek.
`encrypted_file_ids`	Nem üres JSON-tömb a create_encrypt_files által visszaadott fájlazonosítókkal. A fájloknak ugyanahhoz a fiókhoz kell tartozniuk, nem lehetnek lejártak, és meg kell felelniük az entitáskategóriának. Ez nem helyi fájlelérési utak listája.

Űrlapadatok is elfogadhatók ismétlődő encrypted_file_ids[] mezőkkel. Lehetőleg valódi JSON-tömböt vagy űrlaptömböt használjon; ne küldjön JSON formátumban kódolt tömböt egyszerű skalár űrlapértékként.

Az igazolás azonosítójának megőrzése

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

A sikeres válasz az igazolás hozzárendelésének létrehozását erősíti meg. Nem igazolja a személyazonosság vagy a lakcím jóváhagyását, az országra vonatkozó összes követelmény teljesülésének ellenőrzését vagy egy telefonszám aktiválását.

Hibák és lejárt feltöltések

Az API 500 kódja hiányzó kötelező bemeneti adatok, távközlési szolgáltatói hibák és érvénytelen szolgáltatói válasz esetén használatos. A 404 kód akkor használatos, ha a célként megadott entitás nem az aktuális fiókhoz tartozik, az igazolástípus érvénytelen, egy feltöltött fájl nem található az adott fiókhoz vagy kategóriához, illetve lejárt, vagy nem maradt használható fájlazonosító. Olvassa el a status.msg mezőt is a kóddal együtt.

A lejárt kötelező fájlt a csatolás előtt töltse fel újra a megfelelő igazoláskategóriával. Ha bármelyik megadott fájl érvénytelen, ez a kéréskezelő az igazolás létrehozására irányuló kérés elküldése előtt leáll. Idempotenciakulcs nem érhető el: időtúllépés után ellenőrizze a meglévő dokumentumot a portálon, mielőtt megismételné a csatolást.