Yumuşak silme (soft delete)

Yumuşak silme, satırı kaldırmak yerine kaydı işaretler — deleted_at, status: deleted. Veri denetim, geri alma ve bütünlük için kalır; API ise onu yok sayar. Bu, API’nin silinmiş bir kaynak için 404 Not Found yerine daha bilgilendirici olan 410 Gone dönmesini sağlar: tanımlayıcının geçerli olduğunu ve şeyin bilerek artık sunulmadığını söyler.

Nasıl çalışır

Her okuma işaretli satırları dışarıda bırakmalıdır; liste uç noktaları, arama ve sayımlar dahil. Yumuşak silinmiş bir kimliğe yapılan GET 410 döner, ikinci bir DELETE 204 yerine 410 ya da 404 döner; bir temizleme işi de veriyi sonunda — çoğu zaman gizlilik mevzuatının belirleyebileceği bir saklama süresinden sonra — kalıcı olarak siler.

Yaygın yanılgı

Yumuşak silinen verinin gittiği sanılır. Veritabanında, yedeklerde ve çoğu zaman arama dizinlerinde durmaya devam eder; kişisel veriler için yalnızca yumuşak silme bir silme talebini karşılamaz. Filtreyi unutan bir liste uç noktası da silinmiş kayıtları her istemci için diriltir.

Burada deneyin

Yönetici olarak DELETE /protocol/v1/documents/{id} yapın, sonra aynı kimliğe GET gönderin: cevap 404 değil 410’dur. Shop API’sinin süresi dolmuş kuponları ile World Cup ve FIBA’nın iptal edilmiş biletleri de aynı şekilde 410 döner.

İlgili

Kaynaklar

Diğer terimler

Bu sayfayı İngilizce okuyun

Tüm sözlük maddeleri · Test teknikleri · 39 mock REST API’nin tamamı

Son güncelleme