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

https://apis.roblox.com/ordered-data-stores

Liste

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

Sıralanmış bir veri mağazabir dizi giriş döndürür.

Parametreler

universeId string

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.

Path
Gerekli
orderedDataStore string

Hedef veri depolama mağazaadı.

Path
Gerekli
scope string

Veri depolama alanının adı. Alanlar bakın.

Path
Gerekli
max_page_size number

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 .

page_token string

Ö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.

order_by string

Enumerasyon yönü. Varsayılan sıralama yükseliyor. İndirme için bir desc ekini girin.

filter string

Geri dönüş gereken girişlerin nitelik değerlerinin yelpazesi. Görüş Filtreler .

Talep

curl

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

200 - OK
OK
Şunu döndürür: object
entries array<object>

Belirtilen alandan gelen girişler.

nextPageToken string

Sonraki sayfayı almak için page_token olarak gönderilebilecek bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.

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.

  • Oku

Oluştur

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

Verilen içerik değeri ile yeni bir giriş oluşturur.

Parametreler

universeId string

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.

Path
Gerekli
orderedDataStore string

Sipariş edilen veri mağazaadı.

Path
Gerekli
scope string

Veri depolama alanının adı. Alanlar bakın.

Path
Gerekli
id string

Girişin adı.

Gerekli

Talep

curl

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

200 - OK
OK
Şunu döndürür: object
id string

Girişin adı

path string

Talebin kaynak yolu.

value number

Girişin değeri.

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.

  • Yaz

Almak

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

Belirtilen girişi alır ve geri döndürür.

Parametreler

universeId string

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.

Path
Gerekli
orderedDataStore string

Sipariş edilen veri mağazaadı.

Path
Gerekli
scope string

Veri depolama alanının adı. Alanlar bakın.

Path
Gerekli
entry string

Giriş ID'si.

Path
Gerekli

Talep

curl

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

200 - OK
OK
Şunu döndürür: object
id string

Girişin adı

path string

Talebin kaynak yolu.

value number

Girişin değeri.

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.

  • Oku

Silmek

DELETE /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

Belirtilen girişi siler.

Parametreler

universeId string

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.

Path
Gerekli
orderedDataStore string

Sipariş edilen veri mağazaadı.

Path
Gerekli
scope string

Veri depolama alanının adı. Alanlar bakın.

Path
Gerekli
entry string

Giriş ID'si.

Path
Gerekli

Talep

curl

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.

  • Yaz

Güncelle

PATCH /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

Bir giriş değerini günceller ve güncellenmiş girişi döndürür.

Parametreler

universeId string

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.

Path
Gerekli
orderedDataStore string

Sipariş edilen veri mağazaadı.

Path
Gerekli
scope string

Veri depolama alanının adı. Alanlar bakın.

Path
Gerekli
entry string

Giriş ID'si.

Path
Gerekli
allow_missing boolean

Giriş mevcut değilse bir giriş oluşturulmasına izin veren bayrak. Kayıp bayrakları kabul et bakın.

Talep

curl

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

200 - OK
OK
Şunu döndürür: object
id string

Girişin adı

path string

Talebin kaynak yolu.

value number

Girişin değeri.

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.

  • Yaz

Artırma

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}:increment

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

universeId string

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.

Path
Gerekli
orderedDataStore string

Sipariş edilen veri mağazaadı.

Path
Gerekli
scope string

Veri depolama alanının adı. Alanlar bakın.

Path
Gerekli
entry string

Giriş ID'si.

Path
Gerekli

Talep

curl

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

200 - OK
OK
Şunu döndürür: object
id string

Girişin adı

path string

Talebin kaynak yolu.

value number

Girişin değeri.

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.

  • Yaz

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

value number

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

id string

Girişin adı

path string

Talebin kaynak yolu.

value number

Girişin değeri.

IncrementEntryRequest

Artış giriş değerini.

Nitelikler

amount number

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

entries array<object>

Belirtilen alandan gelen girişler.

nextPageToken string

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

value number

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.