API yüklemelerinde tekrarlı istek anahtarı kullanın

Tek istekle yüklemeyi UUID-v4 tekrarlı istek anahtarıyla koruyun. Tekrarı süren işten ayırın. Farklı baytlarla yanlışlıkla yeniden kullanımı reddedin.

Son inceleme

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

dosya.dev tekrar güvenliği tek istekli PUT /api/upload/file yolunda uygulanır. X-Dosya-Idempotency-Key içinde UUID-v4 gönderin. Çok parçalı oturum yollarının parça numarasıyla sürdürme kuralları ayrıdır.

Dört panelde UUID-v4 anahtar bağlanır. İlk 201 yanıtı saklanır. Aynı isteğin tekrarı tanınır. Anahtar başka istekte kullanıldıysa durulur.
Şema UUID-v4 anahtar bağlamayı, ilk 201 yanıtını saklamayı, aynı isteğin tekrarını tanımayı ve anahtar başka istekte kullanıldıysa durmayı gösterir. Ekran görüntüsünü tam boyutta açın.

Başlamadan önce

  • Tek mantıksal yükleme için yeni UUID v4 oluşturun. Sonuç doğrulanana kadar o işle birlikte saklayın.
  • Tekrarlarda çalışma alanı, klasör, ham dosya adı ve Content-Length değişmesin. Bunlar istek parmak izini oluşturur.
  • Otomatik yeniden deneme açılmadan istek gövdesi tekrar gönderilebilir olmalıdır.

Adımlar

  1. 3fa85f64-5717-4562-b3fc-2c963f66afa6 gibi UUID v4 oluşturun. Yerel kaynak yoluyla ve hedefle ilişkilendirin.
  2. Tam Content-Length, taşıyıcı anahtar, gövde ve X-Dosya-Idempotency-Key ile PUT /api/upload/file?file_name=report.pdf&folder_id=folder_id gönderin.
  3. HTTP 201 döndüğünde dosya yanıtını kaydedin. Sunucu tamamlanmış tekrar kaydını 86.400 saniye saklar. Eşleşen yeniden deneme yanıtı geri alabilir.
  4. Belirsiz aktarım hatasında aynı isteği aynı anahtarla tekrarlayın. HTTP 200 ve X-Dosya-Idempotent-Replay: true, dosya.dev hizmetinin ikinci dosya oluşturmadan önceki sonucu döndürdüğünü belirtir.
  5. HTTP 409 ve Retry-After: 5 varsa eşleşen başka istek sürüyordur. Bekleyip yeniden deneyin. Terk edilmiş, sürmekte olan işlemin sahipliği 600 saniye sonra devralınabilir.
  6. 409 ve idempotency_key_reused kodunda durun. Anahtar farklı çalışma alanı, klasör, ham dosya adı veya bildirilen uzunlukla eşleşmiştir. Yalnız gerçekten yeni yükleme için yeni anahtar oluşturun.
API yüklemelerinde tekrarlı istek anahtarı için API ve SDK girişleri sunan dosya.dev geliştirici genel bakışı.
Geliştirici genel bakışı “API yüklemelerinde tekrarlı istek anahtarı kullanın” rehberinin API ve SDK başlangıç noktalarını sunar. Ekran görüntüsünü tam boyutta açın.

Beklenen sonuç

İlk kabul edilen yükleme 201 döndürür. Aynı tekrar, 200 durumu ve tekrar üstbilgisiyle aynı mantıksal sonucu döndürür. Eşleşmeyen parmak izi belirsiz veri oluşturmak yerine reddedilir.

Sorun giderme

Gövde tekrar gönderilemiyor. İlk istekten önce geçici dosyaya yazın veya otomatik yeniden denemeyi kapatın.

Yanıt yeniden kullanım kodu olmadan 409. Retry-After: 5 değerine uyun. İlk işlem hâlâ tamamlanabilecekken yeni anahtar oluşturmayın.

Dosya baytları değişti ama uzunluk aynı. Bütünlük kontrolü için X-Dosya-Sha256 ve yeni mantıksal yükleme için yeni tekrarlı istek anahtarı kullanın.

İ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.