*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

OrderedDataStoreEntry

Sebuah entri kunci-nilai di toko data terurut.

Atribut

pathstring

Jalur sumber daya dari entri toko data yang dipesan.

Format: universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{ordered_data_store_scope_id}/entries/{ordered_data_store_entry_id}.

valuenumber

Nilai dari entri.

Selalu bulat ke bilangan terdekat.

idstring
Hanya Output

Nama entri.

Base URL
https://apis.roblox.com
Resource OrderedDataStoreEntry
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Daftar Memesan Entri Toko Data
Beta

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

Kembalikan daftar entri dari toko data yang diperintahkan.

Cakupan
universe.ordered-data-store.scope.entry:read
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

ordered_data_store_idstring
Diperlukan

ID penyimpanan data yang dipesan.

scope_idstring
Diperlukan

ID bidang.

Parameter Kueri
maxPageSizenumber

Jumlah maksimum entri toko data yang dipesan untuk dikembalikan.Layanan mungkin kembali kurang dari nilai ini.Jika tidak ditentukan, paling banyak 10 entri penyimpanan data yang dipesan dikembalikan.Nilai maksimum adalah 100 dan nilai yang lebih tinggi ditetapkan ke 100.

pageTokenstring

Token halaman, diterima dari panggilan sebelumnya, untuk mengambil halaman berikutnya.

Saat paginasi, semua parameter lain yang disediakan untuk panggilan berikutnya harus cocok dengan panggilan yang memberikan token halaman.

orderBystring

Jika ditentukan, hasil diurutkan sesuai dengan bidang yang ditentukan.

Nilai harus menjadi daftar terpisah koma dari bidang, dengan prefiks "desc" opsional per bidang untuk disortir berdasarkan nilai menurun daripada naik.Anda dapat mengakses subbidang dengan operator ..

Hasil dapat diurutkan oleh bidang berikut: nilai.

Contoh: " value desc".

filterstring

Bidang ini dapat ditetapkan untuk memfilter sumber daya yang dikembalikan.

Kami mendukung dua operator perbandingan untuk operasi ini: <= dan >= .Operator perbandingan ini bertindak sebagai nilai minimum dan nilai maksimum untuk nilai yang dikembalikan.Jika penyaringan diperlukan untuk nilai antara minValue dan maxValue, pengguna dapat menggunakan operator logis &&.Semua token dalam ekspresi filter harus dipisahkan oleh satu spasi.

Contoh filter: entry <= 10 ; entry >= 10 && entry <= 30.

Respons

Daftar Entri OrderedDataStore di koleksi orangtua.

orderedDataStoreEntriesarray<OrderedDataStoreEntry>

Entri OrderedDataStore dari Spektrum OrderedDataStore yang ditentukan.

nextPageTokenstring

Token yang dapat Anda kirim sebagai parameter pageToken untuk mengambil halaman berikutnya. Jika bidang ini diabaikan, tidak ada halaman berikutnya.

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?maxPageSize=10&pageToken={string}&orderBy={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
Respons
{

  "orderedDataStoreEntries": [

    {

      "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

      "value": "number",

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

OrderedDataStoreEntry

Buat Entri Toko Data Terurut
Beta

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

Membuat entri dengan ID dan nilai yang disediakan.

Kembalikan 400 Permintaan Buruk jika entri ada.

Cakupan
universe.ordered-data-store.scope.entry:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

ordered_data_store_idstring
Diperlukan

ID penyimpanan data yang dipesan.

scope_idstring
Diperlukan

ID bidang.

Parameter Kueri
idstring

ID untuk digunakan untuk entri data store yang dipesan, yang akan menjadi komponen terakhir dari jalur sumber daya entri data store yang dipesan.

Nilai ini harus menjadi string karakter 1-63. Kami sangat menyarankan menggunakan hanya huruf kecil, angka numerik, dan hyphen.

Request BodyOrderedDataStoreEntry
ResponsOrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?id=my-entry' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "number"

}'
Respons
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Dapatkan Entri Toko Data Teratur
Beta

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Mendapatkan entri yang ditentukan.

Cakupan
universe.ordered-data-store.scope.entry:read
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

ordered_data_store_idstring
Diperlukan

ID penyimpanan data yang dipesan.

scope_idstring
Diperlukan

ID bidang.

entry_idstring
Diperlukan

ID masuk.

ResponsOrderedDataStoreEntry
GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'
Respons
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Hapus Entri Toko Data Terurut
Beta

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Menghapus entri yang ditentukan.

Pada keberhasilan,返回 200 OK. Jika entri tidak ada,返回 404 Not Found.

Cakupan
universe.ordered-data-store.scope.entry:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

ordered_data_store_idstring
Diperlukan

ID penyimpanan data yang dipesan.

scope_idstring
Diperlukan

ID bidang.

entry_idstring
Diperlukan

ID masuk.

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'

OrderedDataStoreEntry

Perbarui Entri Toko Data yang Ditentukan Pembaruan
Beta

PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Memperbarui nilai entri.

Cakupan
universe.ordered-data-store.scope.entry:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

ordered_data_store_idstring
Diperlukan

ID penyimpanan data yang dipesan.

scope_idstring
Diperlukan

ID bidang.

entry_idstring
Diperlukan

ID masuk.

Parameter Kueri
allowMissingboolean

Jika diatur ke benar, dan entri penyimpanan data yang diperintahkan tidak ditemukan, entri penyimpanan data yang diperintahkan dibuat.

Request BodyOrderedDataStoreEntry
ResponsOrderedDataStoreEntry
PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}?allowMissing={boolean}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "number"

}'
Respons
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Peningkatan Pesanan Data Toko Masuk
Beta

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment

Meningkatkan nilai entri yang ditentukan. Kedua nilai yang ada dan jumlah peningkatan harus menjadi bilangan bulat.

Jika entri tidak ada, membuat entri dengan nilai yang ditentukan.

Masalah yang dikenal: nilai dapat ditingkatkan melewati rentang nilai yang valid.Ketika ini terjadi, nilai yang dikembalikan akan dikunci ke rentang yang valid, tetapi backend dapat mempertahankan nilai asli.Perilaku ini dipertahankan karena alasan kompatibilitas mundur, tetapi bisa berubah di versi masa depan dari API ini.

Cakupan
universe.ordered-data-store.scope.entry:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

ordered_data_store_idstring
Diperlukan

ID penyimpanan data yang dipesan.

scope_idstring
Diperlukan

ID bidang.

entry_idstring
Diperlukan

ID masuk.

Request Body
amountnumber

Jumlah yang digunakan untuk meningkatkan nilai entri. Baik nilai yang ada maupun jumlah peningkatan harus menjadi bilangan bulat.

ResponsOrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "amount": "number"

}'
Respons
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}