Качване на файлове с доказателства за регистрация

Качете преди прикачването

Качете файловете за една категория доказателство или придружаващ документ, след което прикачете върнатите идентификатори на файлове чрез 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.

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