REST - bileşik anahtarlara sahip bir URI nasıl tasarlanır?

Question

Bileşik anahtarlara sahip bir kaynak URI'sı tasarlama hakkında bir sorum var.

4 anahtar/ids'e sahip bir yük kaynağım var: iş ortağı kimliği, ilk zip kodu, son zip kodu ve ağırlığı.

Aslında benim kaynak veritabanı tarafından oluşturulan bir artan kimliğinin olması tasarlanmıştır, ancak bir tüketici/ortak yapmaları gereken bir yük bilgilerinizi güncellemeniz gerekiyorsa bu yaklaşım, örneğin API tüketicilere çok iyi değil edilmiştir:

?

GET navlun initialZipcode = {DEĞER} & finalZipcode = {DEĞER} & ağırlık = {DEĞER}

operasyonun tepkisi yukarıdaki navlun kimliği olacağını, bu yüzden nihayet bilgi güncelleyebilirsiniz:

PUT navlun/{ID}

İş ortağı kimliği kimlik doğrulama mekanizması tarafından örtülüdür.

Bana göre, iş ortakları bilgileri güncellemeden önce navlun kimliğini elde etmek için tuhaf görünüyor.

Bu yüzden sorum şu: Bu URI'yi nasıl tasarlayabilirim?

PUT navlun/initialZipcode/{DEĞERİ}/finalZipCode/{DEĞERİ}/ağırlık/{DEĞERİ}

Yukarıda tasarımını dikkate almak mı?

Başka bir soru: partner kimliğini kimlik doğrulama mekanizmasına katmak için iyi bir uygulamadır? Artıları (tüketicilere kolay) ve eksilerini (önbellek, bir URI'yi paylaşma imkansızlığı vb.) Biliyorum, ancak genelde iyi veya kötü bir uygulama olup olmadığını bilmiyorum.

Teşekkürler!

PUT freight?initialZipcode={VALUE}&finalZipcode={VALUE}&weight={VALUE} 

Sorgu parametreleri ile yanlış bir şey yok

Answer 1

çok kaynak tanımlama parçasıdır.

Yol parametreleri, bir hiyerarşiye iyi uyan kaynakları tanımlamak için kullanışlıdır. Durumunuzda kaynak bir hiyerarşiye uymuyor, bu yüzden parametreleri yol segmentlerine sıkıştırmaya çalışmayın.

Tek sorun, istemci sorgu paramlarının sırasını yeniden düzenlediğinde yapılması gereken şeydir. Aynı kaynak olarak mı davranıyorsunuz yoksa 404 yapıyor musunuz? GET yanıtlarını önbelleğe almıyorsanız, muhtemelen önemli değildir.

İstemcinize, doldurmaları için bir URI şablonu sağladıysanız, size yanlış sırayla paramızları vermeleri için daha az şans vardır. Orijinal öneriyi giderseniz

---

Diğer seçenek, GET bir yönlendirme ve navlun kimliğine sahip URI için bir Konum başlığı döndürür olmasıdır. Örneğin.

GET freight?initialZipcode={VALUE}&finalZipcode={VALUE}&weight={VALUE} 
=> 
302 See Other 
Location: freight/1232321322 

Bunu yaparak, istemci sadece konum başlığını yakalayabilir, navlun kimliği hakkında hiçbir şey bilmek zorunda ve yönlendirmeyi izlemek bir GET yapmak, ya da her ne URI karşı doğrudan bir PUT yapmaz Konum başlığında.Bu, gelecekte kimliği açıklamayı sevmediğinize karar verirseniz, URI'yi herhangi bir müşteriyi kırmadan değiştirebileceğinizi gösterir.