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

GET/v3/documents

სარეგისტრაციო პროფილების სიის მიღება

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

ამ გვერდზე
  1. არსებული სარეგისტრაციო პროფილების მოძებნა
  2. სიის მოთხოვნა
  3. პასუხში დაბრუნებული სია
  4. დაბრუნებული პროფილის ველები
  5. შემდეგი ნაბიჯები

არსებული სარეგისტრაციო პროფილების მოძებნა

მიიღეთ თქვენს API ანგარიშთან დაკავშირებული აქტიური, წაუშლელი ლოკალური სარეგისტრაციო პროფილების სია. გამოიყენეთ ეს სია პროფილის UUID-ის მოსაძებნად, სანამ მას გახსნით შემდეგი ფუნქციით: get_document, და არა იმის დასადგენად, დამტკიცებულია თუ არა მისი დამადასტურებელი მასალები ან ნომრის რეგისტრაცია.

სიის მოთხოვნა

გაიარეთ ავთენტიფიკაცია თქვენი ჩართული MultiTEL API ანგარიშით და მისთვის ნებადართული IP მისამართით. მაგალითებში გამოყენებულია გარემოს ცვლადებში შენახული HTTP Basic ავთენტიფიკაციის მონაცემები. შეამოწმეთ როგორც HTTP პასუხი, ისე JSON-ის ველი status.code; მხოლოდ HTTP 200 პასუხი წარმატებას არ ადასტურებს. მაგალითებში მოცემული ყველა მნიშვნელობა გამოგონილია.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/documents

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

პასუხში დაბრუნებული სია

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": [
    {
      "id": "11111111111111111111111111111111",
      "first_name": "Example",
      "last_name": "Person",
      "phone_number": "12025550123",
      "id_number": "",
      "birth_date": null,
      "company_name": "",
      "company_reg_number": "",
      "vat_id": "",
      "personal_tax_id": "",
      "description": "Example profile",
      "identity_type": "Personal",
      "postal_code": "00000",
      "city": "Example City",
      "address": "1 Example Street",
      "signature": "BASE64_PNG_SIGNATURE_DATA",
      "date_created": "2026-10-23 16:00:00"
    }
  ]
}

თუ შესაბამისი აქტიური პროფილები არ არსებობს, დამმუშავებელი აბრუნებს API კოდს 200 და პასუხის ცარიელ სიას. response[].id არის ლოკალური პროფილის UUID, რომელიც შექმნისას ბრუნდება როგორც uuid; ის არ არის პირადობის მონაცემების ID ან მისამართის ID.

დაბრუნებული პროფილის ველები

დაბრუნებული ველების ნაკრები შეიცავს შემდეგ ველებს: id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature და date_created.

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

შემდეგი ნაბიჯები

მოგვიანებით დანართების მისამაგრებლად შეინახეთ ერთეულების ID-ები საწყისი create_document პასუხიდან. თუ ეს პასუხი დაიკარგა, ამ სიით მათ ვერ აღადგენთ. შეამოწმეთ პროფილი პორტალში ან დაუკავშირდით მხარდაჭერის სამსახურს, ნაცვლად იმისა, რომ ავტომატურად შექმნათ დუბლიკატი.