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.

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-Lengthdeğişmesin. Bunlar istek parmak izini oluşturur. - Otomatik yeniden deneme açılmadan istek gövdesi tekrar gönderilebilir olmalıdır.
Adımlar
3fa85f64-5717-4562-b3fc-2c963f66afa6gibi UUID v4 oluşturun. Yerel kaynak yoluyla ve hedefle ilişkilendirin.- Tam
Content-Length, taşıyıcı anahtar, gövde veX-Dosya-Idempotency-KeyilePUT /api/upload/file?file_name=report.pdf&folder_id=folder_idgönderin. - 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.
- 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. - HTTP 409 ve
Retry-After: 5varsa 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. - 409 ve
idempotency_key_reusedkodunda 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.

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.