Завантаження файлів підтвердження для реєстрації

Завантажте перед прикріпленням

Завантажте файли для однієї категорії підтвердження або додаткових документів, а потім прикріпіть повернуті ідентифікатори файлів за допомогою 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.

Клієнтський ключ ідемпотентності тут не передбачено. Якщо відповідь втрачено, перевірте процес роботи з документами, перш ніж повторювати завантаження; інший запит може створити нові посилання на файли. Ці приклади не виконувалися з документами клієнтів, що посвідчують особу.