Sıralanmış veri depoları (beta sürümü)
*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, sıralı veri depolarıyla çalışmak için referans belgeleri içerir.API'yi kullanma hakkında daha fazla bilgi için, Veri depoları için API isteklerini ele al ve kullanım kılavuzunu görün.
OrderedDataStores
Liste
Sıralanmış bir veri mağazabir dizi giriş döndürür.
Parametreler
Erişmek istediğiniz siparişli veri depolarıyla deneyimin tanımlayıcısı.Bunu Yaratıcı Panosu üzerinde nasıl kopyalayacağınızı görün Evren ID.
Hedef veri depolama mağazaadı.
Veri depolama alanının adı. Alanlar bakın.
Geri döndürülecek maksimum giriş sayısı.Hizmet bu değerden daha azını iade edebilir.Varsayılan değer 10 dir.Maksimum değer 100 , ve 100'in üzerindeki herhangi bir giriş zorlanır 100 .
Önceki bir List çağrısından alınan bir sayfa jetonu.Sonraki sayfayı almak için bunu sağlayın.Sayfa numaralandırırken, tüm diğer parametler List sağlanan çağrı sayfa jetonu sağlayan çağrıya eşleşmelidir.
Enumerasyon yönü. Varsayılan sıralama yükseliyor. İndirme için bir desc ekini girin.
Geri dönüş gereken girişlerin nitelik değerlerinin yelpazesi. Görüş Filtreler .
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
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Oluştur
Verilen içerik değeri ile yeni bir giriş oluşturur.
Parametreler
Erişmek istediğiniz siparişli veri depolarıyla deneyimin tanımlayıcısı.Bunu Yaratıcı Panosu üzerinde nasıl kopyalayacağınızı görün Evren ID.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Alanlar bakın.
Girişin adı.
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
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Almak
Belirtilen girişi alır ve geri döndürür.
Parametreler
Erişmek istediğiniz siparişli veri depolarıyla deneyimin tanımlayıcısı.Bunu Yaratıcı Panosu üzerinde nasıl kopyalayacağınızı görün Evren ID.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Alanlar bakın.
Giriş ID'si.
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
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Silmek
Belirtilen girişi siler.
Parametreler
Erişmek istediğiniz siparişli veri depolarıyla deneyimin tanımlayıcısı.Bunu Yaratıcı Panosu üzerinde nasıl kopyalayacağınızı görün Evren ID.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Alanlar bakın.
Giriş ID'si.
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
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Güncelle
Bir giriş değerini günceller ve güncellenmiş girişi döndürür.
Parametreler
Erişmek istediğiniz siparişli veri depolarıyla deneyimin tanımlayıcısı.Bunu Yaratıcı Panosu üzerinde nasıl kopyalayacağınızı görün Evren ID.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Alanlar bakın.
Giriş ID'si.
Giriş mevcut değilse bir giriş oluşturulmasına izin veren bayrak. Kayıp bayrakları kabul et bakın.
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
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Artırma
Verilen miktar ile anahtarın değerini artırır ve güncellenmiş girişi döndürür.
Bilinen sorun: Giriş değerleri geçerli aralığın ötesine artabilir ve bunlar arka planda kalabilir. Geri döndürülen değerler geçerli aralığa sıkışır.
Parametreler
Erişmek istediğiniz siparişli veri depolarıyla deneyimin tanımlayıcısı.Bunu Yaratıcı Panosu üzerinde nasıl kopyalayacağınızı görün Evren ID.
Sipariş edilen veri mağazaadı.
Veri depolama alanının adı. Alanlar bakın.
Giriş ID'si.
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
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
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
Verilen değerle yeni bir giriş oluşturur.
Nitelikler
Yeni girişi ayarlamak için değer.Giriş değeri int64 tarafından desteklenen maksimum değere ulaşırsa, bu 9,223,372,036,854,775,807, istek 400 Bad Request hatasıyla başarısız olur.
Entry
Bir girişi temsil eder.
Nitelikler
Girişin adı
Talebin kaynak yolu.
Girişin değeri.
IncrementEntryRequest
Artış giriş değerini.
Nitelikler
Giriş değeri ile artırılacak miktar.Giriş değeri int64 tarafından desteklenen maksimum değere ulaşırsa, bu 9,223,372,036,854,775,807, istek 400 Bad Request hatasıyla başarısız olur.
ListEntriesResponse
Ebeveyn koleksiyonundaki girişlerin bir listesi.
Nitelikler
Belirtilen alandan gelen girişler.
Sonraki sayfayı almak için page_token olarak gönderilebilecek bir jeton. Bu alan atlanı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 tarafından desteklenen maksimum değere ulaşırsa, bu 9,223,372,036,854,775,807, istek 400 Bad Request hatasıyla başarısız olur.