Sonraki adımdan önce API değişikliğini doğrulayın

Her API yazma işlemini yolun yanıtıyla ve son durumu okuyarak doğrulayın. D1 yer imlerini yalnız isteğin D1 kullanan parçalarını sıralamak için kullanın.

Son inceleme

Ekran görüntülerinde İngilizce arayüz gösterilir.

2xx yanıtı yolun kendi kurallarına göre isteği kabul ettiğini kanıtlar. Yola özel okuma, sonraki adımın hedef durumu görebildiğini kanıtlar. dosya.dev X-D1-Bookmark ile D1 oturum okumalarını sıralar. Dosya içeriği bu sıra dışındaki çalışma alanı nesnesinde bulunabilir.

Dört panelde beklenen son durum belirlenir. İşlem yanıtı saklanır. Yer imleri D1 sıralamasıyla sınırlanır. Yola özel doğrulama okuması karşılaştırılır.
Şema beklenen son durumu belirlemeyi, işlem yanıtını saklamayı, `X-D1-Bookmark` kullanımını D1 sıralamasıyla sınırlamayı ve yola özel doğrulama okumasını karşılaştırmayı gösterir. Ekran görüntüsünü tam boyutta açın.

Başlamadan önce

  • Değişikliği göndermeden beklenen son durumu belirleyin: tam kimlik, üst klasör, ad, silinme durumu, sürüm veya bayt boyutu.
  • Yolun tekrar davranışını bilin. Tek istekte yüklemenin tekrarlı istek anahtarı vardır. Yalın dosya DELETE isteği ikinci çağrıda kalıcı silmeye dönüşebilir.
  • Durumu ve yanıt gövdesini işlem kanıtı olarak saklayın. Varsa X-D1-Bookmark değerini sonraki D1 okumaları için saklayın.

Adımlar

  1. Kaynağı okuyup mevcut kimliği ve durumu kaydedin. Güncelliğini yitirmiş yerel varsayımları yazma isteğine dönüşmeden reddedin.
  2. Dar kapsamlı tek değişiklik gönderin. Belgelenmiş durum ve alanları doğrulayın. Örnek: taşıma/ad değiştirme için { "ok": true, "name": "…" } veya yüklenen dosya yanıtı.
  3. Yanıt veriyorsa X-D1-Bookmark alın. Sonraki istekte o isteğin D1 oturumunu sıralamak için gönderin. Çalışma alanı nesnesi için depolar arası sıralama oluşturmaz.
  4. Değişikliğe özel doğrulama okumasını yapın. Taşıma/ad değiştirmeden sonra aynı kimliği alın. Çöpe taşımadan sonra silinmişler listesini sorgulayın. Yüklemeden sonra dönen dosya kimliğini alın.
  5. Okumayı önceden belirlenen son durumla karşılaştırın. Eski listenin boş olması, öğenin hedef yeni durumda bulunduğunun kanıtı değildir.
  6. Sonraki bağımlı işlemden önce değişiklik yanıtını ve doğrulanmış durumu kaydedin. Sonuç belirsizse güvenli olmayan yazmayı tekrarlamak yerine durup inceleyin.
API değişikliğini doğrulamak için API ve SDK başlangıç noktaları sunan dosya.dev geliştirici genel bakışı.
Geliştirici genel bakışı “Sonraki adımdan önce API değişikliğini doğrulayın” rehberinin API ve SDK başlangıç noktalarını sunar. Ekran görüntüsünü tam boyutta açın.

Beklenen sonuç

İşlem yanıtı ve yola özel okuma aynı kaynağı ve kaydedilmiş durumu doğrular. Sonraki otomasyon yalnız o işlemin beklenen son durumu görününce başlar. Yer imi yalnız D1 kullanan okumada yardımcı olur.

Sorun giderme

Değişiklik başarılı ama okuma eski görünüyor. Sonraki isteğin aynı kimlik ve çalışma alanını hedeflediğini doğrulayın. D1 durumu için yanıt yer imini iletin. Çalışma alanı nesnesi içeriğini yolun kendi yanıtından değerlendirin.

Yanıt kayboldu. Önce okuyun. Yalnız yol tekrarlı isteğin güvenliğini belgeliyorsa veya gözlenen ön durum ilk isteğin kaydedilmediğini kanıtlıyorsa tekrarlayın.

Eski konum boş. Hedefi veya silinmişler listesini kimlikle kontrol edin. Yokluk tek başına beklenen son durumun tamamı değildir.

İlgili rehberler

Bu rehber yararlı oldu mu?

Değerlendirmeler yükleniyor…

Yanıtınızı değiştirebilmeniz için oy verdiğinizde gerekli bir oylama çerezi kaydedilir. Bu çerez en fazla 180 gün saklanır.

Sorular ve yanıtlar

Bu rehberdeki adımlar hakkında soru sorun. Sorular yayımlanmadan önce incelenir.

Herkese açık sorularda hesap bilgisi, erişim bilgisi veya özel dosya paylaşmayın. Bunlar için özel destek kanalını kullanın.

Sorular yükleniyor…

    dosya.dev hesabınızda oturum açın ve sorunuzu sorun.

    Yeniden denemeden önce sonucu kontrol edin

    Bir işlemi yeniden kontrol etmeniz gerektiğinde bu rehberlerden yararlanın.