დეველოპერებისთვის

GET/v3/get_encrypted_files

რეგისტრაციისთვის ხელმისაწვდომი ატვირთვების სიის მიღება

რეგისტრაციის დოკუმენტების მიმაგრებამდე მოძებნეთ API-ით ატვირთული ფაილების ვადაგაუსვლელი მითითებები და მეტამონაცემები.

ამ გვერდზე
  1. ატვირთვების ხელმისაწვდომი მითითებების სიის მიღება
  2. წაიკითხეთ მეტამონაცემები და არა დოკუმენტის ბაიტები
  3. მიამაგრეთ მითითების მოქმედების ვადის გასვლამდე
  4. კონფიდენციალურობა

ატვირთვების ხელმისაწვდომი მითითებების სიის მიღება

გამოიყენეთ ეს საბოლოო წერტილი შემდეგი მოქმედების შემდეგ: რეგისტრაციის დოკუმენტების ატვირთვა — როდესაც გჭირდებათ ისეთი მითითებების მოძებნა, რომლებიც ჯერ კიდევ ხელმისაწვდომია მიმაგრებისთვის. გამოიყენეთ 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. ატვირთვის სიაში ჩვენება არ ახანგრძლივებს მის მოქმედების ვადას, არ ამაგრებს მას იდენტობის ჩანაწერზე და არ ადასტურებს, რომ სატელეკომუნიკაციო ოპერატორმა ის მოიწონა.

მიამაგრეთ მითითების მოქმედების ვადის გასვლამდე

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

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

კონფიდენციალურობა

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