Sıralama Depoları (Beta)
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Bu sayfa, siparişli veri depolarıyla çalışma ile ilgili referans belgelerini içerir. API'yi kullanma ile ilgili daha fazla bilgi için, Veri Depoları Kullanım Kılavuzu ve API ile Kullanım Kılavuzu bakın.
OrderedDataStores
Liste
Sıralanmış bir veri mağazagelen bir liste içerir.
Parametreler
Erişmek istediğiniz sıralı verilerle dolu deneyimin kimliği. Aşağıdaki kaynaktan kopyalanmayı gösteren Evren ID bakınız.
Hedefin sipariş ettiği veri mağazaadı.
Veri depolama alanının adı. Ayrıca bakın Alanlar.
Geri döndürülecek girişlerin maksimum numarası. Hizmet bu değerden daha az bir değer iade edebilir.Varsayılan değer 10 dir. Maksimum değer 100 dir ve 100'den fazla herhangi bir giriş zorla 100 .
Önceki bir List çağrısından alınan bir sayfa jetonu. Bu sayfayı geri almak için sağlayın. Ödeme yaparken, sağlayıcı olarak sağlanan diğer tüm parametreler List ile eşleşmelidir.
Sıralama yönü.Varsayılan sıralama artan sıralamadır.Sıralamak için desc özel bir eklentisi girin.
Geri dönüş yapacak girişlerin kalite değerlerinin yanında. Ayrıca, Filtreler bakın.
Talep
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'Yanıt
Oluştur
Sunulan içerik değerine sahip yeni bir giriş oluşturur.
Parametreler
Erişmek istediğiniz sıralı verilerle dolu deneyimin kimliği. Aşağıdaki kaynaktan kopyalanmayı gösteren Evren ID bakınız.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Ayrıca bakın Alanlar.
Girişin adı.
Sunulan değerle yeni bir giriş oluşturur.
Talep
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries?id=<id>' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"value": <long>
}'Yanıt
Elde etmek
Belirlenen girişi alır ve döndürür.
Parametreler
Erişmek istediğiniz sıralı verilerle dolu deneyimin kimliği. Aşağıdaki kaynaktan kopyalanmayı gösteren Evren ID bakınız.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Ayrıca bakın Alanlar.
Giriş kimliği.
Talep
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>'Yanıt
Sil
Belirlenen girdi silinir.
Parametreler
Erişmek istediğiniz sıralı verilerle dolu deneyimin kimliği. Aşağıdaki kaynaktan kopyalanmayı gösteren Evren ID bakınız.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Ayrıca bakın Alanlar.
Giriş kimliği.
Talep
curl --location --request DELETE 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>'Yanıt
Güncelleme
Bir giriş değerini günceller ve güncellenen girişi döndürür.
Parametreler
Erişmek istediğiniz sıralı verilerle dolu deneyimin kimliği. Aşağıdaki kaynaktan kopyalanmayı gösteren Evren ID bakınız.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Ayrıca bakın Alanlar.
Giriş kimliği.
Yeni bir değerle sağlanan girişi günceller.
Girişin mevcut olmadığı durumda girişin oluşturulmasına izin vermek için bayrak. Ayrıca, Girişlerin Geçersiz Bayraklarına İzin Vermek bakınız.
Talep
curl --location --request PATCH 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"value": <long>
}'Yanıt
Arttır
Anahtarın değerini sağlanan miktar artırır ve güncellenmiş girişi döndürür.
Bilinen sorun: Giriş değerleri geçerli menzilin ötesine artırılabilir ve bu, back-end'de sürecek şekilde kalabilir. Geri döndürilen değerler geçerli menzile bağlanacaktır.
Parametreler
Erişmek istediğiniz sıralı verilerle dolu deneyimin kimliği. Aşağıdaki kaynaktan kopyalanmayı gösteren Evren ID bakınız.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Ayrıca bakın Alanlar.
Giriş kimliği.
Girdi değerini artırır.
Talep
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>:increment' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"amount": <long>
}'Yanıt
Nesneler
Şu nesneler kabul edilen veya döndürülen yükleri tanımlar. Bu nesnelerin ne zaman kullanıldığı hakkında daha fazla bilgi için tüm uç noktalara bak.
CreateEntryRequest
Sunulan değerle yeni bir giriş oluşturur.
Nitelikler
Yeni girdi ayarlanır. Eğer giriş değeri int64'te desteklenen maksimum değerin aşırısına çıkar, ki bu 9,223,372,036,854,775,807, isteği 400 Bad Request hata ile başarısız olur.
Entry
Bir girişi temsil eder.
Nitelikler
Girişimizin adı
İstekin kaynak yolunu.
Girişimizin değeri.
IncrementEntryRequest
Girdi değerini artırır.
Nitelikler
Giriş değerine artırılacak miktar. Eğer giriş değeri int64'te desteklenen maksimum değeri aşarsa, yani 9,223,372,036,854,775,807, istek 400 Kötü İstek hatasıyla başarısız olur.
ListEntriesResponse
Ana koleksiyonun girişleri listesi.
Nitelikler
Belirlenen alanın girişleri.
Bir jeton, bir sonraki sayfayı almak için şu şekilde gönderilebilir: page_token. Eğer bu alan özelliksiz bırakılırsa, sonraki sayfalar yoktur.
UpdateEntryRequest
Yeni bir değerle sağlanan girişi günceller.
Nitelikler
Girişi güncelleme değeri. Giriş değeri, int64'ün desteklediği maksimum değerin 9,223,372,036,854,775,807, isteği 400 Bad Request hata ile başarısız oldu.