Kullanılabilir kayıt yüklemelerini listeleme

Kullanılabilir yükleme referanslarını listeleme

Bu uç noktayı kayıt belgelerini yükledikten sonra, ekleme işlemi için hâlâ kullanılabilir olan referansları bulmanız gerektiğinde kullanın. Etkin bir MultiTEL API hesabını, hesap için yapılandırılmış kimlik doğrulama bilgileri ve IP kısıtlamalarıyla HTTPS üzerinden kullanın. Liste yalnızca hesabınızın kapsamındadır.

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

İstek gövdesi veya sorgu parametresi gerekmez. İstek işleyicisi, API aracılığıyla oluşturulmuş, süresi doldu işareti etkin olmayan ve son geçerlilik zamanı sunucunun geçerli zamanından sonra olan yükleme kayıtlarını listeler. Sayfalama, arama veya sıralama parametreleri sunmaz. Bu, hesabınızdaki tüm kimliklerin, kanıt belgelerinin veya geçmiş belgelerin listesi değildir.

Belge baytları yerine meta verileri okuma

HTTP sonucunu ve JSON yanıtındaki status.code alanını okuyun. Başarılı bir yanıtta response alanı bir dizi içerir; boş sonuç, hesabın bulunamadığını belirten bir hata değil, boş bir dizidir. Örnekteki meta veriler ve tanımlayıcılar kurgusaldır.

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

Yükleme meta veri alanları
Alan	Anlamı
`id`	Yüklemenin harici referansı. İlgili ekleme isteği için bu değeri aynen kopyalayın. Kendiniz bir tanımlayıcı hesaplamayın ve bu değerin yerine kimlik, adres veya şablon tanımlayıcısı kullanmayın.
`proof_type`	Varsa, kaydedilmiş tür referansının maskelenmiş değeri; yoksa boş bir dize. Kanıt belgesi yüklemelerinde bu değer kanıt belgesinin türüdür; destekleyici belge yüklemelerinde ise şablon referansı aynı anahtar altında kaydedilir. Bunları ayırt etmek için entity_type alanını okuyun. Bu değer yüklemenin tanımlayıcısı değildir.
`entity_type`	identities, addresses veya supporting_documents gibi kaydedilmiş ekleme kategorisi. Bu kategoriye uygun ekleme iş akışını seçin.
`description`	Yüklemenin saklanan açıklaması.
`file_name`	Özgün dosya adı. Bu bir indirme URL'si değildir.
`date`	Kaydedilmiş oluşturulma zamanı; sunucu tarafından saat dilimi farkı eklenmeden biçimlendirilir.

Yanıt belge baytlarını, depolama URL'sini veya son geçerlilik zamanını içermez. İlk yükleme yanıtındaki expired_at değerini saklayın. Bir yüklemenin listelenmesi, geçerlilik süresini uzatmaz, onu bir kimliğe eklemez ve bir telekomünikasyon operatörü tarafından onaylandığını kanıtlamaz.

Referansın süresi dolmadan ekleyin

Uygun kanıt belgesi ekleme veya destekleyici belge ekleme iş akışını kullanın. Mevcut yükleme iş akışında referansların geçerlilik süresi kısadır; bir referans bu listede göründü diye ekleme işlemini geciktirmeyin. Listeleme ile ekleme arasında referansın süresi dolabilir veya referans kullanılamaz hâle gelebilir. İşlemin başarılı olduğunu varsaymak yerine ekleme yanıtını işleyin.

Liste beklenmedik şekilde boşsa hesabı kontrol edin; ayrıca yüklemenin süresinin dolup dolmadığını veya başka bir iş akışı üzerinden oluşturulup oluşturulmadığını denetleyin. İlk yükleme ve ekleme işlemlerinin sonuçlarını kontrol etmeden aynı belgeleri otomatik olarak yeniden yüklemeyin.

Gizlilik

Dosya içerikleri bulunmasa da dosya adları ve açıklamalar kişilerin veya belgelerin kimliğini açığa çıkarabilir. Erişimi sınırlandırın ve yanıtların tamamını günlüğe kaydetmekten kaçının. Kullanılmayan bir yerel yükleme referansını kaldırmak için yükleme referansını kaldırma bölümüne bakın; bu işlem kapsamlı bir belge silme hizmeti değildir.