Priložite dokaz o identitetu ili adresi

Ovaj korak upotrijebite nakon što je identitet ili adresa već stvoren i nakon što prenesete potrebne datoteke putem create_encrypt_files s odabranom vrstom dokaza. Upotrijebite aktualni identifikator iz get_proof_types, koji odgovara zahtjevu i kategoriji entiteta.

Sačuvajte identity_id i address_id iz create_document; UUID profila drugačiji je identifikator. Kompatibilnost naknadnog prilaganja dokaza o adresi za novostvorene profile još se provjerava. Ako je adresa odbijena, provjerite portal ili se obratite podršci prije ponovnog pokušaja.

Stvorite dokaz

Upotrijebite omogućen račun za MultiTEL API i njegovu dopuštenu IP adresu. Primjeri upotrebljavaju vjerodajnice za HTTP Basic iz varijabli okruženja; slijedite pravila autentifikacije za svoju vrstu računa. Šaljite zahtjeve putem protokola HTTPS. Provjerite i HTTP odgovor i JSON polje status.code; pogreške aplikacije mogu stići uz HTTP 200. Primjeri u nastavku su izmišljeni.

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

Polja zahtjeva
Polje	Značenje
`entity_type`	Upotrijebite identities ili addresses. Odaberite kategoriju koja odgovara i ciljnom identitetu ili adresi i prenesenim datotekama.
`entity_id`	Identifikator identiteta ili adrese u vlasništvu vašeg računa. Upotrijebite identifikator koji vraća vaš postupak obrade dokumenata; nemojte ga zamijeniti telefonskim brojem ili identifikatorom nepovezanog dokumenta.
`proof_type_id`	Identifikator odabrane vrste dokaza. Pazite da bude usklađen s prenesenim datotekama i zahtjevom.
`encrypted_file_ids`	Neprazno JSON polje identifikatora datoteka koje vraća create_encrypt_files. Datoteke moraju pripadati istom računu, ne smiju isteći i moraju odgovarati kategoriji entiteta. Ovo nije popis putanja do lokalnih datoteka.

Podaci obrasca prihvaćaju se i uz ponovljena encrypted_file_ids[] polja. Prednost dajte stvarnom polju u formatu JSON ili polju obrasca; nemojte slati polje kodirano u formatu JSON kao običnu skalarnu vrijednost obrasca.

Sačuvajte identifikator dokaza

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

Uspješan odgovor potvrđuje da je stvorena veza s dokazom. Ne potvrđuje odobrenje identiteta ili adrese, provjeru svih zahtjeva države ni aktivaciju telefonskog broja.

Pogreške i istekle prenesene datoteke

API kod 500 upotrebljava se kada nedostaju obvezni ulazni podaci, kada dođe do pogreške kod telekomunikacijskog operatora ili kada je njegov odgovor nevaljan. Kod 404 upotrebljava se kada ciljni identitet ili adresa nije povezan s trenutačnim računom, kada je vrsta dokaza nevaljana, kada prenesenu datoteku nije moguće pronaći za taj račun i kategoriju ili je istekla, ili kada više nema upotrebljivih identifikatora datoteka. Pročitajte status.msg zajedno s kodom.

Prije prilaganja ponovno prenesite isteklu obveznu datoteku uz ispravnu kategoriju dokaza. Ako je bilo koja dostavljena datoteka nevaljana, ova funkcija za obradu zaustavlja se prije slanja zahtjeva za stvaranje dokaza. Ključ idempotentnosti nije dostupan: nakon isteka vremena čekanja provjerite postojeći dokument na portalu prije ponovnog prilaganja.