Прикачете доказателство за самоличност или адрес

Използвайте тази стъпка, след като самоличността или адресът вече съществува и след като качите необходимите файлове чрез create_encrypt_files с избрания тип доказателство. Използвайте актуален идентификатор от get_proof_types, който съответства на изискването и категорията на обекта.

Запазете identity_id и address_id от create_document; UUID на профила е различен. Съвместимостта на последващото прикачване на доказателства за адрес към новосъздадени профили все още се разглежда. Ако адресът бъде отхвърлен, проверете в портала или се свържете с поддръжката, преди да опитате отново.

Създайте доказателството

Използвайте активиран акаунт за MultiTEL API и разрешения за него IP адрес. Примерите използват данни за удостоверяване чрез HTTP Basic от променливи на средата; следвайте правилата за удостоверяване за вашия тип акаунт. Изпращайте заявките през HTTPS. Проверявайте както HTTP отговора, така и стойността в JSON полето status.code; грешки на приложението могат да бъдат получени с HTTP 200. Примерите по-долу са измислени.

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

Полета на заявката
Поле	Значение
`entity_type`	Използвайте identities или addresses. Изберете категорията, която съответства както на целевия обект, така и на качените файлове.
`entity_id`	Идентификатор на самоличността или адреса, които принадлежат на вашия акаунт. Използвайте идентификатора, върнат от процеса за работа с документи; не го заменяйте с телефонен номер или с идентификатор на несвързан документ.
`proof_type_id`	Идентификаторът на избрания тип доказателство. Той трябва да е съгласуван с качването и изискването.
`encrypted_file_ids`	Непразен JSON масив от идентификатори на файлове, върнати от create_encrypt_files. Файловете трябва да принадлежат на същия акаунт, да са с неизтекъл срок на валидност и да съответстват на категорията на обекта. Това не е списък с локални пътища до файлове.

Приемат се и данни от формуляр с повтарящи се полета encrypted_file_ids[]. За предпочитане е да използвате истински JSON масив или масив в данните от формуляра; не изпращайте масив, кодиран във формат JSON, като обикновена скаларна стойност във формуляра.

Запазете идентификатора на доказателството

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

Успешният отговор потвърждава създаването на връзката между доказателството и обекта. Той не потвърждава одобрение на самоличността или адреса, проверка за изпълнение на всички изисквания за съответната държава или активиране на телефонен номер.

Грешки и качени файлове с изтекъл срок на валидност

Код 500 на API се използва при липсващи задължителни входни данни, грешки при оператора и невалиден отговор от оператора. Код 404 се използва, когато целевият обект не е свързан с текущия акаунт, типът доказателство е невалиден, качен файл не може да бъде намерен за този акаунт и тази категория или е с изтекъл срок на валидност, или не са останали използваеми идентификатори на файлове. Прочетете status.msg заедно с кода.

Преди да прикачите задължителен файл с изтекъл срок на валидност, качете го отново, като използвате правилната категория доказателство. Ако някой от предоставените файлове е невалиден, тази обработваща функция спира, преди да изпрати заявката за създаване на доказателството. Не е предоставен ключ за идемпотентност: след изтичане на времето за изчакване проверете съществуващия документ в портала, преди да повторите прикачването.