*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

OrderedDataStoreEntry

Wpis kluczowo-wartościowy w uporządkowanym magazynie danych.

Atrybuty

pathstring

Ścieżka zasobów z zamówionym wejściem do przechowywania danych.

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

valuenumber

Wartość wpisu.

Zawsze zaokrąglone do najbliższego liczby całkowitej.

idstring
Tylko dane wyjściowe

Nazwa wpisu.

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

Lista uporządkowanych wpisów do przechowywania danych
Beta

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

Zwraca listę wpisów z uporządkowanego magazynu danych.

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

ID wszechświata.

ordered_data_store_idstring
Wymagane

ID przechowywania danych zamówionych.

scope_idstring
Wymagane

ID zakresu.

Parametry zapytania
maxPageSizenumber

Maksymalna liczba zamówionych wpisów do przechowywania danych do zwrotu.Usługa może zwrócić mniej niż tę wartość.Jeśli nie określono, zwracane są maksymalnie 10 zamówionych rekordów przechowywania danych.Maksymalna wartość wynosi 100, a wyższe wartości są ustawione na 100.

pageTokenstring

Żeton strony, otrzymany z poprzedniego wezwania, aby odzyskać następną stronę.

Podczas paginowania wszystkie pozostałe parametry dostarczone do następnego wezwania muszą pasować do wezwania, które dostarczyło token strony.

orderBystring

Jeśli zostanie określone, wyniki są sortowane według określonych pól.

Wartości muszą być oddzieloną przecinkami listą pól, z opcjonalnym prefiksem "desc" na polu, aby sortować według malejących wartości, a nie według wzrostowych.Możesz uzyskać dostęp do podpól za pomocą operatora ..

Wyniki mogą być sortowane według następujących pól: wartość.

Przykład: "value desc".

filterstring

Pole to można ustawić w celu filtrowania zasobów zwrotnych.

Wspieramy dwóch operatorów porównawczych dla tej operacji: <= i >=.Te operatory porównawcze działają jako minValue i maxValue dla zwrotanych wartości.Jeśli filtrowanie jest potrzebne dla wartości pomiędzy minValue i maxValue użytkownik może użyć operatora logicznego &&.Wszystkie tokeny w wyrażeniu filtra muszą być oddzielone pojedynczą spacją.

Przykładowe filtry: entry <= 10 ; entry >= 10 && entry <= 30.

Odpowiedź:

Lista wpisów OrderedDataStoreEntries w kolekcji rodziczej.

orderedDataStoreEntriesarray<OrderedDataStoreEntry>

Zamówione dane przechowywane w zakresie z określonym zakresem zamówionych danych.

nextPageTokenstring

Token, który możesz wysłać jako parametr pageToken w celu odzyskania następnej strony. Jeśli to pole zostanie pominięte, nie ma następnych stron.

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

Utwórz kolejną pozycję w magazynie danych uporządkowanych
Beta

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

Tworzy wpis z podanym ID i wartością.

Zwraca 400 zły żądanie, jeśli wpis istnieje.

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

ID wszechświata.

ordered_data_store_idstring
Wymagane

ID przechowywania danych zamówionych.

scope_idstring
Wymagane

ID zakresu.

Parametry zapytania
idstring

ID do użycia dla zamówionego elementu przechowywania danych, który stanie się ostateczną częścią ścieżki zasobów zamówionego elementu przechowywania danych.

Ta wartość powinna być ciągiem znaków A 1-63. Polecamy zdecydowanie używanie tylko małych liter, cyfr i spacji.

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

Zdobądź zamówiony zapis w przechowywaniu danych
Beta

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

Zdobywa określone wejście.

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

ID wszechświata.

ordered_data_store_idstring
Wymagane

ID przechowywania danych zamówionych.

scope_idstring
Wymagane

ID zakresu.

entry_idstring
Wymagane

ID wejścia.

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

Usuń zapis sklepu danych z kolejnością
Beta

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

Usuwa określony wpis.

Po powodzeniu zwraca 200 OK. Jeśli wpis nie istnieje, zwraca 404 Nie znaleziono.

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

ID wszechświata.

ordered_data_store_idstring
Wymagane

ID przechowywania danych zamówionych.

scope_idstring
Wymagane

ID zakresu.

entry_idstring
Wymagane

ID wejścia.

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

Aktualizacja zapisanej kolejności przechowywania danych
Beta

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

Aktualizuje wartość wpisu.

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

ID wszechświata.

ordered_data_store_idstring
Wymagane

ID przechowywania danych zamówionych.

scope_idstring
Wymagane

ID zakresu.

entry_idstring
Wymagane

ID wejścia.

Parametry zapytania
allowMissingboolean

Jeśli ustawiono na prawdę, a nie znaleziono zamówionego wpisu w magazynie danych, tworzony jest zamówiony wpis w magazynie danych.

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

Zwiększona kolejność zapisu przechowywania danych
Beta

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

Zwiększa wartość określonego wpisu. Zarówno istniejąca wartość, jak i wartość wzrostu muszą być liczbami całkowitymi.

Jeśli wpis nie istnieje, tworzy wpis z określoną wartością.

Znany problem: wartość może zostać zwiększona poza ważnym zakresem wartości.Kiedy tak się stanie, zwrócona wartość zostanie przycięta do ważnego zakresu, ale tylny serwer może utrzymać oryginalną wartość.Zachowanie to jest utrzymywane z powodów kompatybilności wstecznej, ale może się zmienić w przyszłej wersji tego API.

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

ID wszechświata.

ordered_data_store_idstring
Wymagane

ID przechowywania danych zamówionych.

scope_idstring
Wymagane

ID zakresu.

entry_idstring
Wymagane

ID wejścia.

Treść żądania
amountnumber

Ilość, z jaką należy zwiększyć wartość wejściową. Zarówno istniejąca wartość, jak i wartość wzrostu muszą być liczbami całkowitymi.

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"

}