Sipariş Uçtan Uca veri feed'inizin yapısı, ilişkisel envanter şeması ile tanımlanır. Siparişin Baştan Sona Veri Feed'i aşağıdaki üst düzey öğelerden oluşur:
Restaurant
varlıkları: Hizmet verdiğiniz restoranlar.Service
öğeleri: Hizmetinizin zamanlaması, konumu ve koşulları.Menu
öğeleri: Her restoranın menüsünün ayrıntıları.
Aşağıdaki şemada Service
, Restaurant
ve Menu
öğelerinin tek bir restoranı nasıl temsil ettiği gösterilmektedir:
Genel yönergeler
Dosya başına restoran sayısı: Her veri dosyası, ilgili
Service
veMenu
varlıklarıyla birlikte bir restoranı temsil etmelidir. Bir restoranla ilgili dosyayı aramanıza yardımcı olabilecek dosya adları kullanın.Veri dosyası biçimi: Veri dosyalarının yeni satırla ayrılmış JSON dosyalarında (ndjson biçimi) biçimlendirilmesi gerekir.
Tarih ve saat değerleri:
DateTime
veyaTime
değeri gerektiren özellikler için Tarih ve saat biçimleri bölümünde belirtilen biçimleri kullanın. Örneğin,DateTime
için2017-05-01T06:30:00+05:30
veTime
içinT08:08:00+05:30
.Kimlikler: Bir varlık türünde bulunan tüm benzersiz varlıkları tanımlamak için
@id
mülkü kullanın. Maksimum uzunluk 300 karakterdir.@id
, ilgili türdeki varlığın benzersiz tanımlayıcısıdır ancak varlıklar arasında kimlikler çakışabilir. Örneğin,@id
özelliğia16
olarak ayarlanmış birService
öğesi tanımladığınızı varsayalım.a16
@id
değerine sahip başka birService
öğesi oluşturamazsınız. Ancak, birMenu
öğesinin@id
değeri olaraka16
kullanabilirsiniz.No Oluşturma: Kimliklerinizi sabit tutun. UUID'ler kullanmayın veya feed yüklemeleri arasında kimlikleri değiştirmeyin/rastgele hale getirmeyin. Bu sayede, öğeyle ilgili sorunlar için daha kolay destek alabilirsiniz.
Boş değerler: Nesneler yerine
null
değerini kullanmayın. İsteğe bağlı bir öğe varsa feed'inizden çıkarmanız gerekir.
İstemci Kitaplıkları
Sipariş uçtan uca veri feed'inizi doğrulamak için Araçlar bölümündeki istemci kodu oluşturucuyu kullanabilirsiniz.