Kayıt profillerini listeleyin

Mevcut kayıt profillerini bulun

API hesabınızla ilişkili etkin ve silinmemiş yerel kayıt profillerini listeleyin. Bir profili açmadan önce UUID'sini bulmak için bu listeyi kullanın. Profili açmak için kullanılacak işlev: get_document. Bu listeyi, profilin kanıt belgelerinin veya numara kaydının onaylanıp onaylanmadığını belirlemek için kullanmayın.

Listeleme isteği

Etkinleştirilmiş MultiTEL API hesabınız ve bu hesap için izin verilen IP adresiyle kimlik doğrulaması yapın. Örneklerde, ortam değişkenlerinde saklanan HTTP Basic kimlik bilgileri kullanılır. Hem HTTP yanıtını hem de JSON içindeki şu alanı kontrol edin: status.code; tek başına HTTP 200 yanıtı işlemin başarılı olduğunu göstermez. Örneklerdeki tüm değerler kurgusaldır.

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

Bu işleyici istek gövdesini, sayfalamayı veya filtre parametrelerini desteklemez. Eşleşen hesabın saklanan profillerini döndürür; belirli bir sıralama olduğunu varsaymayın. Büyük hesaplarda listenin tamamını sık aralıklarla sorgulamaktan kaçının.

Yanıt listesi

{
  "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"
    }
  ]
}

Eşleşen etkin profil olmadığında işleyici, 200 API kodunu ve boş bir yanıt listesi döndürür. response[].id, oluşturma sırasında uuid olarak döndürülen yerel profil UUID'sidir; kimlik ID'si veya adres ID'si değildir.

Döndürülen profil alanları

Seçilen alanlar şunlardır: 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 ve date_created.

İsteğe bağlı değerler, saklanan verilere göre boş veya null olabilir. Eski sürümün bu alan seçimi; email, ülke seçicileri, identity_id, address_id, yüklenen dosyalara yapılan başvurular, kanıt belgesi listeleri ve doğrulama durumunu içermez. Bu, kanıt belgesi durumunu veya kayıt onayını sorgulayan bir uç nokta değildir. Döndürülen kimlik, iletişim ve imza verilerini gizli tutun.

Sonraki adımlar

Daha sonra yapılacak eklemeler için ilk create_document yanıtındaki varlık ID'lerini kaydedin. Bu yanıt kaybolduysa bu liste söz konusu ID'leri geri getiremez. Profili incelemek için şu bağlantıyı kullanın: portal; ya da otomatik olarak yinelenen bir profil oluşturmak yerine destek ekibiyle iletişime geçin.