Standart veri depoları

*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, standart 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.

Datastores

https://apis.roblox.com/datastores

Şu uç noktaları, taban URL'ye göre belirlenen yollarda mevcut.

Veri Depolarını Listele

GET /v1/universes/{universeId}/standard-datastores

Deneyimin veri depolarının bir listesini döndürür.

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
cursor string

Bir sonraki veri setini talep etmek için sağlayın. Görüş Kursörler.

limit number

Geri döndürülecek maksimum eşya sayısı.Her çağrı yalnızca bir bölümü okur, bu nedenle bir bölümdeki hedefler tükenince verilen değerden daha azını geri verebilir.

prefix string

Bu tercih ile sadece veri depolarını geri dönüştürün.

Talep

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "prefix=Player" \

-d "limit=5"

Yanıt

200 - OK
Şunu döndürür: object
application/json
{

  "datastores": [

    {

      "name": "PlayerInventory",

      "createdTime": "2022-02-18T22:38:59.9244932Z"

    },

    {

      "name": "PlayerExperience",

      "createdTime": "2022-02-18T23:00:10.4773508Z"

    },

    {

      "name": "PlayerWeapons",

      "createdTime": "2022-02-18T23:00:22.3725681Z"

    },

    {

      "name": "PlayerArmor",

      "createdTime": "2022-02-18T22:59:33.8472882Z"

    },

    {

      "name": "PlayerHP",

      "createdTime": "2022-02-18T22:58:47.6904028Z"

    }

  ],

  "nextPageCursor": "..."

}
data array<object>

Hedef deneyimdeki bir dizi veri depolaması.

nextPageCursor string

Talep edilen sonuç ayarladaha fazla veri olduğunu gösterir. Görüntüle Kursörler.

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.

  • List Datastores

Entries

https://apis.roblox.com/datastores

Şu uç noktaları, taban URL'ye göre belirlenen yollarda mevcut.

Girişleri listele

GET /v1/universes/{universeId}/standard-datastores/datastore/entries

Veri depolaması içinde bir dizi giriş mağazadöndürür.

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
datastoreName string

Veri mağazaadı.

scope string

Değer varsayılan olarak global dir. Bakınız Alanlar.

allScopes boolean

Tüm alanlardan anahtarları geri göndermek için true değerine ayarlanır.

prefix string

Sadece bu başlıkla geri dönen anahtarlar sağlayın.

cursor string

Bir sonraki veri setini talep etmek için sağlayın. Görüş Kursörler.

limit number

Geri döndürülecek maksimum eşya sayısı.Her çağrı yalnızca bir bölümü okur, bu nedenle bir bölümdeki hedefler tükenince verilen değerden daha azını geri verebilir.

Talep

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "prefix=" \

-d "limit=5"

Yanıt

200 - OK
Şunu döndürür: object
application/json
{

  "keys": [

    {

      "key": "269323"

    }

  ],

  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"

}
keys array<string>

Hedef veri depolamasındaki bir dizi giriş mağaza.

nextPageCursor string

Talep edilen sonuç ayarladaha fazla veri olduğunu gösterir. Görüntüle Kursörler.

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.

  • List Entry Keys

Giriş Alın

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

Bir girişle ilişkili değeri ve metadatları geri döndürür.

Metadatlar takip edilengibi yanıt başlıklarında bulunabilir:

content-md5: zuYxEhwuySMv0i8CitXImw==

roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01

roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| Başlık | Açıklama | |---|---| | content-md5 | İçeriğin temel-64 kodlanmış MD5 kontrol özeti.Bakın İçerik-MD5 .| | roblox-entry-version | Geri döndürülen girişin versiyonu.| | roblox-entry-created-time | Girişin oluşturulduğu zaman.| | roblox-entry-version-created-time | Bu özel sürümün oluştuğu zaman.| | roblox-entry-attributes | Giriş ile etiketlenmiş öznitelikler.Seri JSON harita nesnesi.| | roblox-entry-userids | Roblox kullanıcı kimliklerinin girişle etiketlenmiş koma ayrılmış listesi. |

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
datastoreName string

Veri mağazaadı.

entryKey string

Girişi tanımlayan anahtar.

scope string

Değer varsayılan olarak global dir. Bakınız Alanlar.

Talep

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323"

Yanıt

200 - OK
Giriş başarıyla alındı.
Şunu döndürür: object

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.

  • Read Entry

Girişi Ayarla

POST /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

Bir girişle ilişkili değeri, meta verileri ve kullanıcı kimliklerini ayarlar.

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
datastoreName string

Veri mağazaadı.

entryKey string

Girişi tanımlayan anahtar.

matchVersion string

Mevcut sürüm buna eşleşiyorsa yalnızca güncelleme sağlayın.

exclusiveCreate boolean

Girişi yalnızca mevcut değilse oluşturun.

scope string

Değer varsayılan olarak global dir. Bakınız Alanlar.

roblox-entry-attributes string

Girişin yeni sürümüyle ilişkilendirilecek öznitelikler. JSON harita nesneleri tarafından serilir. Eğer sağlanmazsa, mevcut öznitelikler temizlenir.

Header
roblox-entry-userids string

Giriş ile etiketlenmiş Roblox kullanıcı kimliklerinden ayrı ayrı liste. Eğer verilmezse, mevcut kullanıcı kimlikleri temizlenir.

Header
content-md5 string

İçeriğin temel-64 kodlanmış MD5 özeti. Görüş İçerik-MD5 .

Header

Talep

curl
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry?datastoreName=Coins&entryKey=269323" \

--header "x-api-key: ${API_KEY}" \

--header "content-md5: IGPBYI1uC6+AJJxC4r5YBA==" \

--header "content-type: application/json" \

--header "roblox-entry-userids: [269323]" \

--header "roblox-entry-attributes: {}" \

--d "value"

Yanıt

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

Nitelikli girişin versiyon adı.

deleted boolean

Girişin silinip silinmediğini belirtir.

contentLength number

İçerik uzunluğu.

createdTime string

Sürümün ISO saat formatında oluşturulduğu tarih zaman damgası.

objectCreatedTime string

Veri depolarının ISO saat formatında oluşturulduğu tarih zaman damgası.

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.

  • Create Entry

  • Update Entry

Girişi Sil

DELETE /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

Girişi bir mezar taşı versiyonu oluşturarak siler. Girişler 30 gün sonra kalıcı olarak silinir.

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
datastoreName string

Veri mağazaadı.

entryKey string

Girişi tanımlayan anahtar.

scope string

Değer varsayılan olarak global dir. Bakınız Alanlar.

Talep

curl
curl --include --location --request DELETE "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323"

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.

  • Delete Entry

Artırma Girişi

POST /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/increment

Bir girişin değerini belirlenen miktar ile artırır veya bu miktarla yeni bir giriş oluşturur. Giriş ve metadatları geri döndürür.

Metadatlar takip edilengibi yanıt başlıklarında bulunabilir:

content-md5: zuYxEhwuySMv0i8CitXImw==

roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01

roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| Başlık | Açıklama | |---|---| | content-md5 | İçeriğin temel-64 kodlanmış MD5 kontrol özeti.Bakın İçerik-MD5 .| | roblox-entry-version | Geri döndürülen girişin versiyonu.| | roblox-entry-created-time | Girişin oluşturulduğu zaman.| | roblox-entry-version-created-time | Bu özel sürümün oluştuğu zaman.| | roblox-entry-attributes | Giriş ile etiketlenmiş öznitelikler.Seri JSON harita nesnesi.| | roblox-entry-userids | Roblox kullanıcı kimliklerinin girişle etiketlenmiş koma ayrılmış listesi. |

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
datastoreName string

Veri mağazaadı.

entryKey string

Girişi tanımlayan anahtar.

incrementBy number

Girişin artırılması gereken miktar veya mevcut değilse başlangıç değeri.

scope string

Değer varsayılan olarak global dir. Bakınız Alanlar.

roblox-entry-attributes string

Girişin yeni sürümüyle ilişkilendirilecek öznitelikler. JSON harita nesneleri tarafından serilir. Eğer sağlanmazsa, mevcut öznitelikler temizlenir.

Header
roblox-entry-userids string

Girişin etiketlendiği Roblox kullanıcı kimliklerinin virgülle ayrılmış bir listesi. Eğer verilmezse, mevcut kullanıcı kimlikleri temizlenir.

Header

Talep

curl
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/increment" \

--header "x-api-key: ${API_KEY}" \

--header 'content-length: 0' \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323" \

-d "incrementBy=3"

Yanıt

200 - OK
Artırıldıktan sonra girişin en son sürümünü döndürür.
Şunu döndürür: object

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.

  • Create Entry

  • Update Entry

Giriş Sürümü Alın

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/versions/version

Bir girişin belirli bir sürümünün değerini ve metadatasını döndürür.

Metadatlar takip edilengibi yanıt başlıklarında bulunabilir:

content-md5: zuYxEhwuySMv0i8CitXImw==

roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01

roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| Başlık | Açıklama | |---|---| | content-md5 | İçeriğin temel-64 kodlanmış MD5 kontrol özeti.Bakın İçerik-MD5 .| | roblox-entry-version | Geri döndürülen girişin versiyonu.| | roblox-entry-created-time | Girişin oluşturulduğu zaman.| | roblox-entry-version-created-time | Bu özel sürümün oluştuğu zaman.| | roblox-entry-attributes | Giriş ile etiketlenmiş öznitelikler.Seri JSON harita nesnesi.| | roblox-entry-userids | Roblox kullanıcı kimliklerinin girişle etiketlenmiş koma ayrılmış listesi. |

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
datastoreName string

Veri mağazaadı.

entryKey string

Girişi tanımlayan anahtar.

versionId string

İncelenecek sürüm.

scope string

Değer varsayılan olarak global dir. Bakınız Alanlar.

Talep

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions/version" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323" \

-d "versionId=08D9E6A3F2188CFF.0000000003.08D9E6DE485A7680.01"

Yanıt

200 - OK
Giriş başarıyla alındı.
Şunu döndürür: object

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.

  • Read Version

Sınırlar

API Anahtarı başına: Her 60 saniyede IP adresi başına 5000 talep

Giriş Sürümlerini Listele

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/versions

Bir giriş için bir sürüm listesi döndürür.

Parametreler

universeId number

Erişmek istediğiniz veri depolama ile deneyimin tanımlayıcısı.Deneyiminizin Evren ID'sini yeniden düzenleyebilirsiniz Yaratıcı Panosu üzerinde.

Path
Gerekli
datastoreName string

Veri mağazaadı.

entryKey string

Girişi tanımlayan anahtar.

scope string

Değer varsayılan olarak global dir. Bakınız Alanlar.

cursor string

Bir sonraki veri setini iste (bakın Kursörler).

startTime string

Bu tarihten önceki sürümleri dahil etmemeyi sağlayın.

endTime string

Bu tarihten sonraki sürümleri dahil etmemeyi sağlayın.

sortOrder string

Ya Ascending (önceki sürümler ilk) ya da Descending (daha sonraki sürümler ilk).

limit number

Geri döndürülecek maksimum eşya sayısı.Her çağrı yalnızca bir bölümü okur, bu nedenle bir bölümdeki hedefler tükenince verilen değerden daha azını geri verebilir.

Talep

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323" \

-d "limit=5"

Yanıt

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

Nitelikli girişin versiyon adı.

deleted boolean

Girişin silinip silinmediğini belirtir.

contentLength number

İçerik uzunluğu.

createdTime string

Sürümün ISO saat formatında oluşturulduğu tarih zaman damgası.

objectCreatedTime string

Veri depolarının ISO saat formatında oluşturulduğu tarih zaman damgası.

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.

  • List Versions

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.

DataStore

Adı ve oluşturulma zamanı ile veri depolama nesnesi.

Nitelikler

name string

Veri mağazaadı.

createdTime string

Veri depolarının ISO saat formatında oluşturulduğu tarih zaman damgası.

EntryVersion

List Entry Versions yöntemi tarafından döndürülen giriş versiyonu nesnesi.

Nitelikler

version string

Nitelikli girişin versiyon adı.

deleted boolean

Girişin silinip silinmediğini belirtir.

contentLength number

İçerik uzunluğu.

createdTime string

Sürümün ISO saat formatında oluşturulduğu tarih zaman damgası.

objectCreatedTime string

Veri depolarının ISO saat formatında oluşturulduğu tarih zaman damgası.