Liitä henkilöllisyys- tai osoitetodiste

Käytä tätä vaihetta, kun henkilöllisyys tai osoite on luotu ja sen edellyttämät tiedostot on ladattu toiminnolla create_encrypt_files käyttäen valittua todistetyyppiä. Käytä ajantasaista tunnistetta, jonka palauttaa get_proof_types ja joka vastaa vaatimusta ja entiteettiluokkaa.

Tallenna identity_id ja address_id, jotka palauttaa create_document; profiilin UUID on eri tunniste. Osoitetodisteen myöhemmän liittämisen yhteensopivuutta uusien profiilien kanssa selvitetään edelleen. Jos osoite hylätään, tarkista asia portaalista tai ota yhteyttä tukeen ennen uutta yritystä.

Luo todiste

Käytä käyttöön otettua MultiTEL API -tiliä ja sille sallittua IP-osoitetta. Esimerkeissä käytetään ympäristömuuttujista saatavia HTTP Basic -tunnuksia; noudata tilityyppisi todennuskäytäntöjä. Lähetä pyynnöt HTTPS-yhteydellä. Tarkista sekä HTTP-vastaus että seuraava JSON-kenttä: status.code; sovellusvirheitä voi tulla myös tilakoodilla HTTP 200. Alla olevat esimerkit ovat kuvitteellisia.

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

Pyynnön kentät
Kenttä	Merkitys
`entity_type`	Käytä arvoa identities tai addresses. Valitse luokka, joka vastaa sekä kohdetta että ladattuja tiedostoja.
`entity_id`	Tilillesi kuuluvan henkilöllisyyden tai osoitteen tunniste. Käytä asiakirjatyönkulun palauttamaa tunnistetta; älä korvaa sitä puhelinnumerolla tai asiaan liittymättömän asiakirjan tunnisteella.
`proof_type_id`	Valitun todistetyypin tunniste. Varmista, että se vastaa latauksessa käytettyä tyyppiä ja vaatimusta.
`encrypted_file_ids`	Ei-tyhjä JSON-taulukko, joka sisältää toiminnon create_encrypt_files palauttamat tiedostotunnisteet. Tiedostojen on kuuluttava samalle tilille, oltava edelleen voimassa ja vastattava entiteettiluokkaa. Tämä ei ole luettelo paikallisista tiedostopoluista.

Myös lomaketiedot hyväksytään, kun niissä toistuvat encrypted_file_ids[]-kentät. Käytä mieluiten aitoa JSON-taulukkoa tai lomaketaulukkoa; älä lähetä JSON-koodattua taulukkoa tavallisena skalaarisena lomakearvona.

Tallenna todisteen tunniste

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

Onnistunut vastaus vahvistaa, että todisteen liitos on luotu. Se ei vahvista henkilöllisyyden tai osoitteen hyväksymistä, kaikkien maakohtaisten vaatimusten validointia eikä puhelinnumeron aktivointia.

Virheet ja vanhentuneet lataukset

API-koodia 500 käytetään, kun pakollisia syötteitä puuttuu, operaattorilla ilmenee virhe tai operaattorin vastaus on virheellinen. Koodia 404 käytetään, kun kohdetta ei ole liitetty nykyiseen tiliin, todistetyyppi on virheellinen, ladattua tiedostoa ei löydy tälle tilille ja luokalle tai se on vanhentunut, tai kun käyttökelpoisia tiedostotunnisteita ei ole jäljellä. Lue status.msg yhdessä koodin kanssa.

Lataa vanhentunut pakollinen tiedosto uudelleen oikeaa todisteluokkaa käyttäen ennen sen liittämistä. Jos yksikin annetuista tiedostoista on virheellinen, tämä käsittelijä keskeyttää toiminnan ennen todisteen luontipyynnön lähettämistä. Idempotenssiavainta ei ole saatavilla: tarkista aikakatkaisun jälkeen olemassa oleva asiakirja portaalista ennen liittämisen toistamista.