OrderedDataStoreEntry

A key-value entry in an ordered data store.

Atrybuty

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
Tylko dane wyjściowe

The name of the entry.

Podstawowy adres URL
https://apis.roblox.com
Zasób 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.

Zakresy
universe.ordered-data-store.scope.entry:read
ŻądanieParametry ścieżki
universe_idstring
Wymagane

The universe ID.

ordered_data_store_idstring
Wymagane

The ordered-data-store ID.

scope_idstring
Wymagane

The scope ID.

Parametry zapytania
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.

Odpowiedź:

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}'
Odpowiedź:
{

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

Zakresy
universe.ordered-data-store.scope.entry:write
ŻądanieParametry ścieżki
universe_idstring
Wymagane

The universe ID.

ordered_data_store_idstring
Wymagane

The ordered-data-store ID.

scope_idstring
Wymagane

The scope ID.

Parametry zapytania
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.

Treść żądaniaOrderedDataStoreEntry
Odpowiedź: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"

}'
Odpowiedź:
{

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

Zakresy
universe.ordered-data-store.scope.entry:read
ŻądanieParametry ścieżki
universe_idstring
Wymagane

The universe ID.

ordered_data_store_idstring
Wymagane

The ordered-data-store ID.

scope_idstring
Wymagane

The scope ID.

entry_idstring
Wymagane

The entry ID.

Odpowiedź: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}'
Odpowiedź:
{

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

Zakresy
universe.ordered-data-store.scope.entry:write
ŻądanieParametry ścieżki
universe_idstring
Wymagane

The universe ID.

ordered_data_store_idstring
Wymagane

The ordered-data-store ID.

scope_idstring
Wymagane

The scope ID.

entry_idstring
Wymagane

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.

Zakresy
universe.ordered-data-store.scope.entry:write
ŻądanieParametry ścieżki
universe_idstring
Wymagane

The universe ID.

ordered_data_store_idstring
Wymagane

The ordered-data-store ID.

scope_idstring
Wymagane

The scope ID.

entry_idstring
Wymagane

The entry ID.

Parametry zapytania
allowMissingboolean

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

Treść żądaniaOrderedDataStoreEntry
Odpowiedź: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"

}'
Odpowiedź:
{

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

Zakresy
universe.ordered-data-store.scope.entry:write
ŻądanieParametry ścieżki
universe_idstring
Wymagane

The universe ID.

ordered_data_store_idstring
Wymagane

The ordered-data-store ID.

scope_idstring
Wymagane

The scope ID.

entry_idstring
Wymagane

The entry ID.

Treść żądania
amountnumber

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

Odpowiedź: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"

}'
Odpowiedź:
{

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

}