Kullanılmayan bir yükleme referansı seçin
Bu uç nokta, hesabınıza ait bir yükleme referansı kaydını kaldırır. Yalnızca referansın şu işlemler için artık gerekmediğinden emin olduğunuzda kullanın: kanıt ekleme veya destekleyici belge ekleme. Kayıt işlemine ait bir kimliği veya adresi silmez.
Harici dosya kimliğini şu kaynaklardan alın: ilk yükleme yanıtı veya kullanılabilir yüklemeler listesi. İşleyici önce hesabınız için bu kimliği arar; bulamazsa eski sağlayıcı kimliğiyle aramayı dener. Yeni entegrasyonlar harici referansı tam olarak döndürüldüğü biçimde kullanmalıdır. İstek gövdesi gerekmez.
Kaldırma isteğini bilinçli bir işlem olarak gönderin
Etkin bir MultiTEL API hesabını, yapılandırılmış kimlik bilgileri ve IP kısıtlamalarıyla HTTPS üzerinden kullanın. Uygulamanızın bunu bilinçli bir değişiklik olarak ele alması için POST kullanın:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefMevcut işleyici bir HTTP yöntemi kısıtlaması uygulamaz: bir GET isteği de silme işlemine ulaşabilir. Bu URL'yi sıradan bir tıklanabilir bağlantı, resim, yer imi, önizleme veya önceden getirme hedefi olarak sunmayın. Uygulamanızda açık bir kaldırma eylemi gerektirin ve otomatik olarak yeniden denemeyin.
Sonucu ve sınırlarını yorumlayın
Hem HTTP sonucunu hem de JSON içindeki status.code alanını okuyun. Normal başarılı yanıt şöyledir:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Failed, Not found ile birlikte gelen API kodu 404, iki aramanın da bu hesap için eşleşen bir referans bulamadığı anlamına gelir. Bu nedenle tekrarlanan bir kaldırma işlemi 404 döndürebilir. Yol değerinin başındaki ve sonundaki boşluklar temizlenir. Burada referansın süresinin dolmadığı veya başka bir adım tarafından kullanılmadığı kontrol edilmez; bu yüzden kaldırmadan önce iş akışınızı kontrol edin.
İşleyici, veritabanından silmeyi denedikten sonra silme işleminin başarılı olup olmadığını kontrol etmeden başarı bildirir. Yanıtı, silmenin bağımsız kanıtı olarak değil, bildirilen sonuç olarak değerlendirin. API aracılığıyla oluşturulmuş, süresi dolmamış bir referans get_encrypted_files listesinde görünüyorsa bu liste, referansın görünür kalıp kalmadığını kontrol etmeye yardımcı olabilir; ancak listede bulunmaması süresinin dolduğu anlamına da gelebilir.
Kaldırma, verilerin tamamen silinmesi değildir
İşleyici, yükleme referansı tablosuna yönelik bir silme işlemi başlatır. Saklanan belge içeriği satırını, yerel olarak yüklenmiş dosyayı, eklenmiş kanıtı, kimliği, destekleyici belgeyi veya sağlayıcının tuttuğu kopyayı açıkça silmez. Veritabanındaki zincirleme işlemlerin ve saklama davranışının nasıl işlediği doğrulanmamıştır. Bu işlemi kullanıcılara kimlik belgelerinin tüm kopyalarını siliyormuş veya kapsamlı bir silme talebini karşılıyormuş gibi sunmayın.
Yerel referans kaldırıldıktan sonra, bu referansa ihtiyaç duyan sonraki ekleme adımları başarısız olabilir. Daha önce tamamlanmış ekleme işlemlerinin sonuçlarını saklayın ve gönderilmiş kayıt bilgilerini değiştirirken ilgili kimlik veya kanıt yönetimi iş akışını kullanın.