Toplu bir uç nokta, tek bir istekte bir öğe dizisi — oluşturulacak kayıtlar, silinecek kimlikler — kabul eder ve her öğe için bir gidiş-dönüşten tasarruf ettirir. Bazı öğeler başarılı olurken bazıları başarısız olabileceği için yanıt her birini ayrı bildirir; 207 Multi-Status tam olarak bu durumun durum kodudur: “içine bak, sonuçlar farklı”.
Yanıt gövdesi her öğe için bir durum listeler; genellikle istekteki sırayla ya da istemcinin verdiği bir kimlikle eşlenmiş olarak. Atomiklik konusunda tasarımlar farklıdır: bazı toplu işlemler ya hep ya hiçtir ve herhangi bir öğe geçersizse tek bir 4xx döner; bazıları yapabildiğini kaydeder ve geri kalanını bildirir. API hangisi olduğunu belgelemelidir.
Toplu bir istekte 2xx’in her şeyin çalıştığı anlamına geldiği sanılır. 207 başarı sınıfındadır ve yalnızca response.ok’a bakan bir istemci, kayıtlarının yarısı reddedilmişken başarı bildirir. Toplu istemciler öğe başına sonuçları tek tek gezmelidir.
POST /friends/v1/characters/bulk her öğeyi ayrı doğrular ve bazıları başarısız olduğunda 207 döner; POST /friends/v1/characters/bulk-delete de kısmi başarıyı aynı şekilde bildirir. Görmek için iyi öğelerin arasına bir hatalı öğe koyun.
Tüm sözlük maddeleri · Test teknikleri · 39 mock REST API’nin tamamı
Son güncelleme