Sortowane magazyny danych (beta)
*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.
Ta strona zawiera dokumentację referencyjną dotyczącą pracy z uporządkowanymi magazynami danych.Aby uzyskać więcej informacji na temat korzystania z API, zobacz obsługę żądań API dla magazynów danych i przewodnik użytkowania.
OrderedDataStores
Lista
Zwraca listę wpisów z uporządkowanego sklepdanych.
Parametry
Identyfikator doświadczenia z przechowywanymi danymi zamówionymi, do których chcesz uzyskać dostęp.Zobacz ID wszechświata na temat tego, jak go skopiować na Pulpicie nawigacyjnym twórcy.
Nazwa przeznaczonego sklepu danych docelowego.
Nazwa zakresu przechowywania danych. Zobacz Zakresy.
Maksymalna liczba wpisów do zwrotu.Usługa może zwrócić mniej niż tę wartość.Domyślną wartością jest 10 .Maksymalna wartość to 100 , a każde wpisanie powyżej 100 jest zmuszane do 100 .
Żeton strony otrzymany z poprzedniego wezwania List.Dostarcz to, aby odzyskać następną stronę.Podczas paginowania wszystkie pozostałe parametry dostarczone do List muszą pasować do wezwania, które dostarcza token strony.
Kierunek enumeracji. Domyślny porządek to wzrost. Wprowadź prefiks desc dla spadku.
Zakres kwalifikujących się wartości wpisów do zwrotu. Zobacz filtry.
Żądanie
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'Odpowiedź:
Wymagane uprawnienia
Do wywołania tego punktu końcowego wymagane są następujące uprawnienia do kluczy API. Więcej informacji na temat generowania odpowiednich kluczy można znaleźć w obszarze Zarządzanie kluczami API.
Tworzyć
Tworzy nową pozycję z podaną wartością zawartości.
Parametry
Identyfikator doświadczenia z przechowywanymi danymi zamówionymi, do których chcesz uzyskać dostęp.Zobacz ID wszechświata na temat tego, jak go skopiować na Pulpicie nawigacyjnym twórcy.
Nazwa zamówionego sklepu danych.
Nazwa zakresu przechowywania danych. Zobacz Zakresy.
Nazwa wpisu.
Żądanie
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries?id=<id>' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"value": <long>
}'Odpowiedź:
Wymagane uprawnienia
Do wywołania tego punktu końcowego wymagane są następujące uprawnienia do kluczy API. Więcej informacji na temat generowania odpowiednich kluczy można znaleźć w obszarze Zarządzanie kluczami API.
Otrzymaj
Zdobywa i zwraca określone wejście.
Parametry
Identyfikator doświadczenia z przechowywanymi danymi zamówionymi, do których chcesz uzyskać dostęp.Zobacz ID wszechświata na temat tego, jak go skopiować na Pulpicie nawigacyjnym twórcy.
Nazwa zamówionego sklepu danych.
Nazwa zakresu przechowywania danych. Zobacz Zakresy.
ID wejścia.
Żądanie
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>'Odpowiedź:
Wymagane uprawnienia
Do wywołania tego punktu końcowego wymagane są następujące uprawnienia do kluczy API. Więcej informacji na temat generowania odpowiednich kluczy można znaleźć w obszarze Zarządzanie kluczami API.
Usuń
Usuwa określony wpis.
Parametry
Identyfikator doświadczenia z przechowywanymi danymi zamówionymi, do których chcesz uzyskać dostęp.Zobacz ID wszechświata na temat tego, jak go skopiować na Pulpicie nawigacyjnym twórcy.
Nazwa zamówionego sklepu danych.
Nazwa zakresu przechowywania danych. Zobacz Zakresy.
ID wejścia.
Żądanie
curl --location --request DELETE 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>'Odpowiedź:
Wymagane uprawnienia
Do wywołania tego punktu końcowego wymagane są następujące uprawnienia do kluczy API. Więcej informacji na temat generowania odpowiednich kluczy można znaleźć w obszarze Zarządzanie kluczami API.
Aktualizacja
Aktualizuje wartość rekordu i zwraca zaktualizowany rekord.
Parametry
Identyfikator doświadczenia z przechowywanymi danymi zamówionymi, do których chcesz uzyskać dostęp.Zobacz ID wszechświata na temat tego, jak go skopiować na Pulpicie nawigacyjnym twórcy.
Nazwa zamówionego sklepu danych.
Nazwa zakresu przechowywania danych. Zobacz Zakresy.
ID wejścia.
Flaga, aby umożliwić utworzenie wpisu, jeśli wpis nie istnieje. Zobacz Pozwolenie na brakujące flagi.
Żądanie
curl --location --request PATCH 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"value": <long>
}'Odpowiedź:
Wymagane uprawnienia
Do wywołania tego punktu końcowego wymagane są następujące uprawnienia do kluczy API. Więcej informacji na temat generowania odpowiednich kluczy można znaleźć w obszarze Zarządzanie kluczami API.
Zwiększenie
Zwiększa wartość klucza o podany kwant i zwraca zaktualizowany wpis.
Znany problem: wartości wejściowe mogą wzrosnąć poza ważnym zakresem i może to utrzymać się w tylnej części. Powracające wartości będą pasować do ważnego zakresu.
Parametry
Identyfikator doświadczenia z przechowywanymi danymi zamówionymi, do których chcesz uzyskać dostęp.Zobacz ID wszechświata na temat tego, jak go skopiować na Pulpicie nawigacyjnym twórcy.
Nazwa zamówionego sklepu danych.
Nazwa zakresu przechowywania danych. Zobacz Zakresy.
ID wejścia.
Żądanie
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>:increment' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"amount": <long>
}'Odpowiedź:
Wymagane uprawnienia
Do wywołania tego punktu końcowego wymagane są następujące uprawnienia do kluczy API. Więcej informacji na temat generowania odpowiednich kluczy można znaleźć w obszarze Zarządzanie kluczami API.
Obiekty
Następujące obiekty opisują ładunki, które są przyjmowane lub zwracane. Więcej informacji na temat tego, kiedy te obiekty są w użyciu, można znaleźć w poszczególnych punktach końcowych.
CreateEntryRequest
Tworzy nową pozycję z podaną wartością.
Atrybuty
Wartość do ustawienia nowego wpisu.Jeśli wartość wejściowa przekracza maksymalną wartość wspieraną przez int64, która wynosi 9,223,372,036,854,775,807, żądanie kończy się błędem 400 Bad Request.
Entry
Reprezentuje wejście.
Atrybuty
Nazwa wpisu
Ścieżka zasobów z prośba.
Wartość wpisu.
IncrementEntryRequest
Zwiększenie wartości wejściowej.
Atrybuty
Ilość, którą należy zwiększyć o wartość wejściową.Jeśli wartość wejściowa przekracza maksymalną wartość wspieraną przez int64, która wynosi 9,223,372,036,854,775,807, żądanie kończy się błędem 400 Bad Request.
ListEntriesResponse
Lista wpisów w kolekcjamacierzystej.
Atrybuty
Wpisy z określonego zakresu.
Token, który można wysłać jako page_token aby odzyskać następną stronę. Jeśli to pole zostanie pominięte, nie ma następnych stron.
UpdateEntryRequest
Aktualizuje wpis dostarczony za pomocą nowej wartości.
Atrybuty
Wartość do aktualizacji wpisu.Jeśli wartość wejściowa przekracza maksymalną wartość wspieraną przez int64, która wynosi 9,223,372,036,854,775,807, żądanie kończy się błędem 400 Bad Request.