Atașați un document justificativ pentru identitate sau adresă

Efectuați acest pas după ce identitatea sau adresa există și după ce ați încărcat fișierele necesare prin create_encrypt_files cu tipul de document justificativ selectat. Folosiți un identificator actual din get_proof_types, care corespunde cerinței și categoriei entității.

Păstrați identity_id și address_id din create_document; identificatorul UUID al profilului este diferit. Compatibilitatea atașării ulterioare a documentelor justificative pentru adresă la profilurile nou create este încă în curs de evaluare. Dacă adresa este respinsă, verificați în portal sau contactați serviciul de asistență înainte de a reîncerca.

Creați documentul justificativ

Folosiți un cont API MultiTEL activat și adresa IP permisă pentru acesta. Exemplele folosesc date de autentificare HTTP Basic din variabilele de mediu; respectați convențiile de autentificare pentru tipul dumneavoastră de cont. Trimiteți cererile prin HTTPS. Verificați atât răspunsul HTTP, cât și câmpul din JSON status.code; erorile aplicației pot fi returnate cu HTTP 200. Exemplele de mai jos sunt fictive.

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

Câmpurile cererii
Câmp	Semnificație
`entity_type`	Folosiți identities sau addresses. Alegeți categoria care corespunde atât entității vizate, cât și fișierelor încărcate.
`entity_id`	Identificatorul identității sau al adresei care aparține contului dumneavoastră. Folosiți identificatorul returnat de fluxul de lucru pentru documente; nu îl înlocuiți cu un număr de telefon sau cu identificatorul unui document fără legătură.
`proof_type_id`	Identificatorul tipului de document justificativ selectat. Asigurați-vă că acesta corespunde încărcării și cerinței.
`encrypted_file_ids`	Un tablou JSON nevid cu identificatorii de fișiere returnați de create_encrypt_files. Fișierele trebuie să aparțină aceluiași cont, să nu fi expirat și să corespundă categoriei entității. Aceasta nu este o listă de căi către fișiere locale.

Sunt acceptate și date de formular cu repetarea câmpurilor encrypted_file_ids[] în formular. Preferați un tablou JSON propriu-zis sau un tablou de formular; nu trimiteți un tablou codificat în JSON ca valoare scalară obișnuită a unui câmp de formular.

Păstrați identificatorul documentului justificativ

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

Un răspuns reușit confirmă crearea asocierii documentului justificativ. Acesta nu confirmă aprobarea identității/adresei, validarea tuturor cerințelor țării sau activarea unui număr de telefon.

Erori și fișiere încărcate expirate

Codul API 500 este folosit pentru date de intrare obligatorii lipsă, erori ale operatorului și un răspuns nevalid din partea operatorului. Codul 404 este folosit când entitatea vizată nu este asociată contului curent, tipul de document justificativ este nevalid, un fișier încărcat nu poate fi găsit pentru acest cont/această categorie sau a expirat ori nu mai există identificatori de fișiere utilizabili. Citiți status.msg împreună cu codul.

Încărcați din nou un fișier obligatoriu expirat, folosind categoria corectă de document justificativ, înainte de a-l atașa. Dacă oricare dintre fișierele furnizate este nevalid, acest handler se oprește înainte de a trimite cererea de creare a documentului justificativ. Nu este pusă la dispoziție nicio cheie de idempotență: după expirarea timpului de așteptare, verificați documentul existent în portal înainte de a repeta atașarea.