ატვირთვების ხელმისაწვდომი მითითებების სიის მიღება
გამოიყენეთ ეს საბოლოო წერტილი შემდეგი მოქმედების შემდეგ: რეგისტრაციის დოკუმენტების ატვირთვა — როდესაც გჭირდებათ ისეთი მითითებების მოძებნა, რომლებიც ჯერ კიდევ ხელმისაწვდომია მიმაგრებისთვის. გამოიყენეთ MultiTEL-ის გააქტიურებული API ანგარიში HTTPS-ის მეშვეობით, მისთვის კონფიგურირებული ავტორიზაციის მონაცემებითა და IP შეზღუდვებით. სია მხოლოდ თქვენს ანგარიშს მოიცავს.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesმოთხოვნის სხეული ან მოთხოვნის სტრიქონის პარამეტრები საჭირო არ არის. დამმუშავებელი აბრუნებს API-ით შექმნილი ატვირთვების ჩანაწერების სიას, რომელთა ვადის გასვლის ალამი დაყენებული არ არის და რომელთა მოქმედების ვადის დასასრული სერვერის მიმდინარე დროზე გვიანაა. გვერდებად დაყოფის, ძიების ან დახარისხების პარამეტრები გათვალისწინებული არ არის. ეს არ არის თქვენს ანგარიშში არსებული ყველა იდენტობის ჩანაწერის, დამადასტურებელი საბუთის ან ისტორიული დოკუმენტის სია.
წაიკითხეთ მეტამონაცემები და არა დოკუმენტის ბაიტები
წაიკითხეთ HTTP შედეგი და JSON-ის status.code ველი. წარმატებული პასუხის response ველი შეიცავს მასივს; ცარიელი შედეგი ცარიელი მასივია და არა ანგარიშის არარსებობის შეცდომა. მაგალითში გამოყენებულია გამოგონილი მეტამონაცემები და იდენტიფიკატორები.
{
"status": {"code": 200, "msg": ""},
"response": [{
"id": "0123456789abcdef0123456789abcdef",
"proof_type": "abcdef0123456789abcdef0123456789",
"entity_type": "addresses",
"description": "Example address proof",
"file_name": "example-document.pdf",
"date": "2026-10-01 12:00:00"
}]
}| ველი | მნიშვნელობა |
|---|---|
id | ატვირთვის გარე მითითება. შესაბამის მიმაგრების მოთხოვნაში გამოსაყენებლად ზუსტად დააკოპირეთ იგი. თავად არ გამოთვალოთ იდენტიფიკატორი და მის ნაცვლად არ გამოიყენოთ იდენტობის ჩანაწერის, მისამართის ან შაბლონის იდენტიფიკატორი. |
proof_type | არსებობის შემთხვევაში — ჩაწერილი ტიპის შენიღბული მითითება, სხვა შემთხვევაში — ცარიელი სტრიქონი. დამადასტურებელი საბუთების ატვირთვისას ეს საბუთის ტიპია; დამატებითი დოკუმენტების ატვირთვისას შაბლონის მითითება ამავე გასაღებით იწერება. მათ გასარჩევად წაიკითხეთ entity_type. ეს არ არის ატვირთვის იდენტიფიკატორი. |
entity_type | ჩაწერილი მიმაგრების კატეგორია, მაგალითად, identities, addresses ან supporting_documents. აირჩიეთ მიმაგრების შესაბამისი სამუშაო პროცესი. |
description | ატვირთვის შენახული აღწერა. |
file_name | ფაილის თავდაპირველი სახელი. ეს არ არის ჩამოტვირთვის URL-მისამართი. |
date | ჩაწერილი შექმნის დრო, რომელსაც სერვერი აფორმატებს დროის სარტყლის წანაცვლების გარეშე. |
პასუხი არ შეიცავს დოკუმენტის ბაიტებს, საცავის URL-მისამართს ან მოქმედების ვადის დასასრულს. შეინახეთ ატვირთვის თავდაპირველი პასუხიდან მიღებული expired_at. ატვირთვის სიაში ჩვენება არ ახანგრძლივებს მის მოქმედების ვადას, არ ამაგრებს მას იდენტობის ჩანაწერზე და არ ადასტურებს, რომ სატელეკომუნიკაციო ოპერატორმა ის მოიწონა.
მიამაგრეთ მითითების მოქმედების ვადის გასვლამდე
გამოიყენეთ შესაბამისი დამადასტურებელი საბუთის მიმაგრების ან დამატებითი დოკუმენტის მიმაგრების სამუშაო პროცესი. ატვირთვის მიმდინარე სამუშაო პროცესში მითითებებს მოქმედების მოკლე ვადა აქვს; ნუ გადადებთ მიმაგრებას მხოლოდ იმიტომ, რომ მითითება ამ სიაში გამოჩნდა. სიაში ჩვენებასა და მიმაგრებას შორის მითითებას შეიძლება ვადა გაუვიდეს ან ის მიუწვდომელი გახდეს. დაამუშავეთ მიმაგრების პასუხი და წინასწარ ნუ ჩათვლით, რომ მოქმედება წარმატებით დასრულდა.
თუ სია მოულოდნელად ცარიელია, შეამოწმეთ ანგარიში და ის, ხომ არ გაუვიდა ატვირთვას ვადა ან ხომ არ შეიქმნა იგი სხვა სამუშაო პროცესით. იმავე დოკუმენტებს ავტომატურად ნუ ატვირთავთ ხელახლა, სანამ თავდაპირველი ატვირთვისა და მიმაგრების შედეგებს არ შეამოწმებთ.
კონფიდენციალურობა
ფაილების სახელებითა და აღწერებით შესაძლებელია ადამიანების ან დოკუმენტების იდენტიფიცირება მაშინაც კი, როცა ფაილის შიგთავსი არ არის წარმოდგენილი. შეზღუდეთ წვდომა და მოერიდეთ სრული პასუხების ჟურნალში ჩაწერას. გამოუყენებელი ადგილობრივი ატვირთვის მითითების წასაშლელად იხილეთ ატვირთვის მითითების წაშლა; ეს ოპერაცია არ წარმოადგენს დოკუმენტების სრულად წაშლის სერვისს.