OrderedDataStoreEntry

A key-value entry in an ordered data store.

คุณลักษณะ

pathstring

The resource path of the ordered data store entry.

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

valuenumber

The value of the entry.

Always rounded to the nearest integer.

idstring
เอาต์พุตเท่านั้น

The name of the entry.

URL หลัก
https://apis.roblox.com
แหล่งข้อมูล 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

List Ordered Data Store Entries
เวอร์ชัน Beta

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

Returns a list of entries from an ordered data store.

ขอบเขต
universe.ordered-data-store.scope.entry:read
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

The universe ID.

ordered_data_store_idstring
จำเป็นต้องมี

The ordered-data-store ID.

scope_idstring
จำเป็นต้องมี

The scope ID.

พารามิเตอร์คิวรี
maxPageSizenumber

The maximum number of ordered data store entries to return. The service might return fewer than this value. If unspecified, at most 10 ordered data store entries are returned. The maximum value is 100 and higher values are set to 100.

pageTokenstring

A page token, received from a previous call, to retrieve a subsequent page.

When paginating, all other parameters provided to the subsequent call must match the call that provided the page token.

orderBystring

If specified, results are ordered according to the specified fields.

Values must be a comma-separated list of fields, with an optional, per-field " desc" suffix to sort by descending rather than ascending values. You can access subfields with a . operator.

Results may be ordered by the following fields: value.

Example: "value desc".

filterstring

This field may be set in order to filter the resources returned.

We support two comparison operators for this operation: <= and >=.These comparison operators act as a minValue and maxValue for the values returned. If filtering is needed for a value between a minValue and maxValue the user can use the logical operator &&. All tokens in the filter expression must be separated by a single space.

Example filters: entry <= 10; entry >= 10 && entry <= 30.

การตอบกลับ

A list of OrderedDataStoreEntries in the parent collection.

orderedDataStoreEntriesarray<OrderedDataStoreEntry>

The OrderedDataStoreEntries from the specified OrderedDataStoreScope.

nextPageTokenstring

A token that you can send as a pageToken parameter to retrieve the next page. If this field is omitted, there are no subsequent pages.

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}'
การตอบกลับ
{

  "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

Create Ordered Data Store Entry
เวอร์ชัน Beta

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

Creates an entry with the provided ID and value.

Returns a 400 Bad Request if the entry exists.

ขอบเขต
universe.ordered-data-store.scope.entry:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

The universe ID.

ordered_data_store_idstring
จำเป็นต้องมี

The ordered-data-store ID.

scope_idstring
จำเป็นต้องมี

The scope ID.

พารามิเตอร์คิวรี
idstring

The ID to use for the ordered data store entry, which will become the final component of the ordered data store entry's resource path.

This value should be A 1-63 character string. We strongly recommend using only lowercase letters, numeric digits, and hyphens.

เนื้อหาคำขอOrderedDataStoreEntry
การตอบกลับOrderedDataStoreEntry
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"

}'
การตอบกลับ
{

  "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

Get Ordered Data Store Entry
เวอร์ชัน Beta

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

Gets the specified entry.

ขอบเขต
universe.ordered-data-store.scope.entry:read
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

The universe ID.

ordered_data_store_idstring
จำเป็นต้องมี

The ordered-data-store ID.

scope_idstring
จำเป็นต้องมี

The scope ID.

entry_idstring
จำเป็นต้องมี

The entry ID.

การตอบกลับOrderedDataStoreEntry
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}'
การตอบกลับ
{

  "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

Delete Ordered Data Store Entry
เวอร์ชัน Beta

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

Deletes the specified entry.

On success, returns 200 OK. If the entry doesn't exist, returns 404 Not Found.

ขอบเขต
universe.ordered-data-store.scope.entry:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

The universe ID.

ordered_data_store_idstring
จำเป็นต้องมี

The ordered-data-store ID.

scope_idstring
จำเป็นต้องมี

The scope ID.

entry_idstring
จำเป็นต้องมี

The entry ID.

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

Update Ordered Data Store Entry
เวอร์ชัน Beta

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

Updates the value of an entry.

ขอบเขต
universe.ordered-data-store.scope.entry:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

The universe ID.

ordered_data_store_idstring
จำเป็นต้องมี

The ordered-data-store ID.

scope_idstring
จำเป็นต้องมี

The scope ID.

entry_idstring
จำเป็นต้องมี

The entry ID.

พารามิเตอร์คิวรี
allowMissingboolean

If set to true, and the ordered data store entry is not found, a ordered data store entry is created.

เนื้อหาคำขอOrderedDataStoreEntry
การตอบกลับOrderedDataStoreEntry
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"

}'
การตอบกลับ
{

  "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

Increment Ordered Data Store Entry
เวอร์ชัน Beta

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

Increments the value of the specified entry. Both the existing value and the increment amount must be integers.

If the entry doesn't exist, creates an entry with the specified value.

Known issue: the value may be incremented past the valid range of values. When this happens, the returned value will be clamped to the valid range, but the backend may persist the original value. This behavior is maintained for backwards compatibility reasons, but may change in a future version of this API.

ขอบเขต
universe.ordered-data-store.scope.entry:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

The universe ID.

ordered_data_store_idstring
จำเป็นต้องมี

The ordered-data-store ID.

scope_idstring
จำเป็นต้องมี

The scope ID.

entry_idstring
จำเป็นต้องมี

The entry ID.

เนื้อหาคำขอ
amountnumber

The amount by which to increment the entry value. Both the existing value and the increment amount must be integers.

การตอบกลับOrderedDataStoreEntry
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"

}'
การตอบกลับ
{

  "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"

}