Genel bakış

Sipariş Verme Uçtan Uca veri feed'inizin yapısı ilişkisel envanter şeması tarafından tanımlanır. Sıralama Uçtan Uca veri feed'i aşağıdaki üst düzey varlıklardan oluşur:

Aşağıdaki şemada Service, Restaurant ve Menu öğelerinin tek bir restoranı nasıl temsil ettiği gösterilmektedir:

Restoran Hizmeti Menüsü sınıf ilişkisi diyagramı
Şekil 1: Sipariş Verme Uçtan Uca veri feed'i varlıklarının genel ilişkisi: Hizmet, Restoran ve Menü.

Genel yönergeler

  • Dosya başına restoranlar: Her veri dosyası, ilgili Service ve Menu varlıklarına sahip bir restoranı temsil etmelidir. Dosyada bir restoran aramanıza yardımcı olabilecek dosya adları kullanın.

  • Veri dosyası biçimi: Veri dosyalarının yeni satırla ayrılmış JSON dosyaları (ndjson biçimi) olarak biçimlendirilmesi gerekir.

  • DateTime and Time değerleri: DateTime veya Time değeri gerektiren özellikler için DateTime ve Time biçimlerinde belirtilen biçimleri kullanın. Örneğin, DateTime için 2017-05-01T06:30:00+05:30 ve Time için T08:08:00+05:30.

  • Kimlikler: Bir varlık türü içindeki tüm benzersiz varlıkları tanımlamak için @id özelliği kullanın. En çok 300 karakter kullanılabilir. @id, söz konusu türdeki varlığın benzersiz tanımlayıcısıdır ancak varlıklar arasında kimlikler çakışabilir. Örneğin, @id özelliği a16 olarak ayarlanmış bir Service varlığı tanımladığınızı varsayalım. @id değeri a16 olan başka bir Service varlığı oluşturamazsınız. Ancak, bir Menu varlığının @id değeri olarak a16 kullanabilirsiniz.

  • Kimlik Oluşturma: Kimliklerinizi sabit tutun. UUID'ler kullanmayın veya feed yüklemeleri arasında kimlikleri başka şekilde değiştirin/rastgeleleştirin. Bu sayede varlıkla ilgili sorunlar için daha kolay destek alabilirsiniz.

  • Boş değerler: Nesnelerin yerine null değerini kullanmayın. İsteğe bağlı olan nesneleri feed'inizden çıkarmanız gerekir.

İstemci Kitaplıkları

Araçlar bölümündeki istemci kodu oluşturma aracı, Sipariş Verme Uçtan Uca veri feed'inizi doğrulamak için kullanılabilir.