Отпремање датотека са доказима за регистрацију

Отпремите пре прилагања

Отпремите датотеке за једну категорију доказа или пратећег документа, па затим приложите враћене идентификаторе датотека помоћу create_proof или create_supporting_document. Само отпремање не ствара идентитет, адресу, доказ нити довршену регистрацију броја. Почните од актуелних захтева и идентификатора из каталога.

Наведите тачно један селектор: proof_type_id за доказ идентитета или адресе, или supporting_template_id за пратећи документ. Немојте слати оба. Користите идентификаторе које враћа одговарајући MultiTEL каталог; третирајте их као непрозирне идентификаторе чију структуру не треба тумачити.

Захтев за отпремање

Користите омогућен MultiTEL API налог и његову дозвољену IP адресу. Примери користе акредитиве за HTTP Basic аутентификацију из променљивих окружења; придржавајте се правила аутентификације за свој тип налога. Шаљите захтеве преко HTTPS-а. Проверите и HTTP одговор и JSON поље status.code; грешке апликације могу стићи уз HTTP 200. Примери у наставку су измишљени.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

Поља захтева
Поље	Значење
`files[0] … files[4]`	Од једне до пет отпремљених датотека. Користите вишеделне податке обрасца и препустите алату curl да генерише гранични низ за Content-Type. Ова поља садрже бајтове датотека, а не URL адресе или Base64 податке у JSON-у.
`proof_type_id`	Обавезно при отпремању доказа; користите враћени идентификатор типа доказа. Изоставите supporting_template_id.
`supporting_template_id`	Обавезно уместо proof_type_id за пратеће датотеке; користите враћени идентификатор шаблона.
`description`	Необавезан опис који доставља позивалац, највише 100 знакова. При отпремању пратећих датотека може се користити назив шаблона ако је опис изостављен.

Ограничења датотека

Овај обрађивач прихвата највише пет датотека и укупно 20,000,000 бајтова. Ово је децимално ограничење у бајтовима, а не 20 MiB. Инфраструктура или MIME валидација могу наметнути додатна ограничења.

Дозвољени наставци датотека су pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf и csv. Дозвољен наставак не потврђује да датотека испуњава изабрани захтев за регистрацију. Конкретно, tif није на овој листи дозвољених наставака.

Проверите сваку враћену датотеку

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

Сачувајте сваки response.ids[].id за захтев за прилагање. name означава враћени назив изворне датотеке. Користите различите називе датотека и упоредите враћене датотеке са очекиваним скупом: код 200 може означавати делимично успешну групну обраду. Немојте прилагати скуп у ком недостају обавезне датотеке.

entity_type има вредност identities или addresses за доказ, а supporting_documents за отпремање пратећих датотека. document_category има вредност proof или supporting. Поље одговора са општим називом proof_type такође садржи референцу на шаблон при отпремању пратећих датотека; сачувајте свој првобитни supporting_template_id за прилагање.

Приложите без одлагања

Услуга поставља истек важења приближно 20 минута након локалног чувања отпремљене датотеке. Приликом прилагања проверава се да датотека припада истом налогу, да није означена као истекла, да јој рок важења још није истекао и да има одговарајућу категорију ентитета. expired_at у овом одговору нема помак временске зоне; немојте претпостављати да је у UTC-у. Приложите без одлагања, уместо да заказујете обраду непосредно на истеку рока.

Истек важења референце на отпремљену датотеку није обећање да ће све сачуване копије документа тада бити обрисане. Услуга шифрује датотеке за отпремање оператору и задржава изворне бајтове за поступак обраде докумената; немојте ово сматрати шифровањем искључиво на страни клијента нити услугом која не задржава податке. Не уносите идентификаторе, називе датотека и одговоре у јавне евиденције.

Грешке и поновни покушаји

Тренутни обрађивач користи API код 404 када нису достављене датотеке докумената, а код 500 за проблеме са валидацијом описа, недостајуће или међусобно противречне селекторе, неважеће идентификаторе доказа или шаблона, ограничење броја датотека или укупне величине, проблеме са складиштењем или неуспешно отпремање. Прочитајте status.msg; неважећи улазни подаци нису доследно представљени кодом 400.

Овде није доступан клијентски кључ идемпотентности. Ако се одговор изгуби, проверите поступак обраде докумената пре него што поновите отпремање; други захтев може створити нове референце на датотеке. Ови примери нису извршавани над документима за потврду идентитета клијената.