რეგისტრაციისთვის დამადასტურებელი ფაილების ატვირთვა

მიმაგრებამდე ატვირთეთ

ატვირთეთ ერთი დამადასტურებელი ან დამხმარე დოკუმენტის კატეგორიის ფაილები, შემდეგ კი დაბრუნებული ფაილების იდენტიფიკატორები მიამაგრეთ შემდეგი ფუნქციით: 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

ფაილების შეზღუდვები

ეს დამმუშავებელი იღებს მაქსიმუმ ხუთ ფაილს, რომელთა ჯამური ზომა არ აღემატება 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 არ აღინიშნება.

აქ კლიენტისთვის იდემპოტენტურობის გასაღები ხელმისაწვდომი არ არის. თუ პასუხი დაიკარგა, ატვირთვის გამეორებამდე შეამოწმეთ დოკუმენტების სამუშაო პროცესი; კიდევ ერთმა მოთხოვნამ შეიძლება ფაილების ახალი მითითებები შექმნას. ეს მაგალითები მომხმარებელთა პირადობის დამადასტურებელ დოკუმენტებზე არ შესრულებულა.