Приложите доказ о идентитету или адреси

Користите овај корак након што идентитет или адреса већ постоји и након што отпремите потребне датотеке путем 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 заједно са кодом.

Пре прилагања поново отпремите обавезну датотеку којој је истекао рок важења, користећи одговарајућу категорију доказа. Ако је било која достављена датотека неважећа, овај обрађивач се зауставља пре слања захтева за креирање доказа. Кључ идемпотентности није доступан: након истека времена за одговор, проверите постојећи документ на порталу пре него што поновите прилагање.