REST API Ürün Detaylandırma

KerimCETINBAS

Merhaba arkadaşlar rest kavramı beni gerçekten zorluyor.
soyle bi product ve category entity classim var

type Product struct {
...
	Name        string
	Categories  []*Category `gorm:"many2many:product_category;"`
...
}


type Category struct {
...
	Name        string
	Products    []*Product `gorm:"many2many:product_category;"`
...
}

sorum su mesela bir tane category getiren bir endpointim olsun
/categories/1 oldugunu varsayalim

categorinin icindeki productlari cliente nasil iletmeliyim bunun best practicesi nedir

a. productlari kategori icinde yolla

{
...
name: "some category name",
products: [
{
   name: "product name"
...
}
{
   name: "product name 2"
...
}
...
}

b. tum productlar icin bir endpoint yolla

{
name: "some category name",
products: "https://example.com/categories/1/products"
...
}

c. her product icin ayri bir endpoint yolla

{
name: "some category name",
products: [
 "https://example.com/products/1",
 "https://example.com/products/2",
 "https://example.com/products/3",
....
]
...
}

``

Halil Han BADEM

KerimCETINBAS Merhaba,

Burada kullanım önemli, eğer sadece kategori listelenecek ise ürünleri getirmene gerek yok. Kategori listesi içerisinde ürünlerde gelecek ise ilgili JSON verisine gerekli ürün alanlarını eklemen gerekir yalnız pagination kullanman gerekecek. Burada en uygun olan A seçeneği.

C seçeneği için ürünlere gitmek için ek bir request yapman gerekecek. Otomatik olarak API sistemine yük binecek.
B seçeneği ise tek bir tane de olsa ek bir request bile olsa yüke sebep olacak. 100 tane kategori olduğunu düşünürsen bu işlem yükü fazla gelecektir belirli bir zaman sonra.

A seçeneği neden doğru?
Bu seçenek ile en az request ile ve gerekli bilgiler ile birlikte veriyi elde etmiş oluyorsun. Diğer türlü adresini göndermiş olduğunu URL için bir URI tanımlaman gerekecek. Yani normal ürün detayı farklı kategoriden ürün detayı farklı olmuş olacak. URI tanımı arttıkça kontrolü zorlaşacak.

Umarım anlatabilmişimdir.

KerimCETINBAS

Merhaba Halil hocam;

a şıkkı üzerinden gidersem, Pagination i client tarafında mi yapmalıyım yoksa request sırasında mı?,

kategorileri limitlemek için su tarz bir querystring gönderiyorum

{
   limit?: number;
   offset?: number;

}

bu şekilde birşeye mi çevirmeliyim, bunun başka bir standardı var midir

{
   limit?: number;
   offset?: number;
   products?: {
          limit?: number;
          offset?: number;
   }

}

svt

Bence de A şıkkı doğru cevap.

KerimCETINBAS Pagination i client tarafında mi yapmalıyım yoksa request sırasında mı?,

Aslında ikisi de

Genelde next ve previous diye iki değer döner pagination'da ileri ve geri gidebilmek için. Sadece ileri doğru gitmek istiyorsan sırf next döndürebilirsin.

Client tarafı mı request sırası mı derken tam olarak ne demek istediğini anlamadım. Client gelen response'ta next var mı diye bakacak, varsa tekrar request göndericek.

Server'ın ise next değerini anlaması gerekiyor. Örneğin verin bir şekilde sort edildiyse, next için direkt offset kullanabilirsin.

Halil Han BADEM

KerimCETINBAS Selamlar,

Bahar alerjimden dolayı tek gözle bilgisayar kullanıyordum cevap verecek takatim yoktu 😃
@svt ile sanırım konu netleşmiş.

İyi çalışmalar dilerim 🚀

KerimCETINBAS

ozur dilerim soruyu yanlış ifade etmişmişim. ordan kastım butun productları getır. client tarafında paginate et. yada server'a şukadar product getir de

Apiyi farkli clientler tüketicek. Kategori içinde farklı sayıda producta ihtiyaç duyabilirler.

demek istediğim client n sayıda producta ihtiyac duyarken digeri m sayıda producta ihtiyac duyablır.

n = 30 dersek server her sayfa için 20 product donuyorsa fazladan 1 request daha atmam gerekecek. bu durumda a. şıkkının anlamı kalmıyor

a. şıkkı üzerinden gitmem gerekiyorsa şöyle birşey daha mantıklı olmaz mı?

// GET /categories?+qs.toString()

const qs = new URLSearchParams()

// kac kategori gelecek
qs.append("limit", 20)
qs.append("offset", 0)

// her kategoride kac urun olacak
qs.append("products", encodeURIComponent(JSON.stringify({ limit: 10, offset: 0})))

bunun bana dondugu cevap soyle birşey olsa

{
    name: "category 1",
    products: { 
        count: 60, // kategorideki toplam product sayisi
        items: [ ... /*kategori icindeki her bir urun */]
    }
}

bunu client tarafinda hesaplayip 2. sayfa gerektiginde, sonraki 10 product icin yine istek atabilirim

const qs = new URLSearchParams()


qs.append("products", encodeURIComponent(JSON.stringify({ limit: 10, offset: 10})))

gerçi initial load dan sonra /categories/1 içinde istek atılabilir

fikirlerinizi bekliyorum hocalarim

svt

KerimCETINBAS Apiyi farkli clientler tüketicek. Kategori içinde farklı sayıda producta ihtiyaç duyabilirler.

Anladım.

Buradaki esas düşünmen gereken ne kadar ürün var? Eğer 100 ürün varsa toplam, client tek bir sayfada 20 bile kullanacak olsa bence tek seferde 100 ürünü yollaman daha mantıklı.

Eğer 1 milyon ürün varsa o zaman client'ın her sayfa için istek yollaması daha mantıklı.

limit ve offseti tam olarak niye kullandığını hala anlamadım ve bence gerek yok.

KerimCETINBAS // kategorideki toplam product sayisi

Bunu client'ın bilmesine gerek yok (pagination için). Client'ın tek bilmesi gereken, next var mı yok mu. Varsa istek gönderir, yoksa göndermez.

Sonuçta bu senin kodun ve istediğini yapabilirsin. Sen standart nedir diye sordun, standart server tarafında hesaplayıp client'a token göndermek. AWS'ten bir örnek: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.Pagination.html

Database isteğinde pagination için sana sonuçta tek bir değer dönüyor.

KerimCETINBAS

Merhaba @svt hocam;

stackoverflow da soyle birsey buldum, dynamonun yaklasimina benzer birsey. aslinda sizin ilk dediginiz şeye geliyormus.

{
    "elements": [
        {"data": "data", "modificationDate": 1512757070}
        {"data": "data", "modificationDate": 1512757072}
        {"data": "data", "modificationDate": 1512757072}
    ],
    "pagination": {
        "continuationToken": "1512757072_2",
        "nextPage": "https://domain.de/api/elements?continuationToken=1512757072_2"
    }
}

KerimCETINBAS

Halil Han BADEM Merhaba

Sayenizde teşekkür ederim; Geçmiş olsun