Przechowywanie danych z zamówienia (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ę odniesienia do pracy z przechowywaniami danych zleconych. For more information on using the API, see Przygotowanie API do danych and the Przewodnik po użyciu.
OrderedDataStores
Lista
Zwraca listę wpisów z przechowywania danych zamówionych.
Parametry
Zidentyfikator doświadczenia z przechowywanymi danymi, które chcesz uzyskać dostęp do. Zobacz identyfikator uniwersum na jakim sposób kopiować go na Creator Dashboard.
Nazwa celu, dla którego zamówiono przechowywanie danych.
Nazwa zakresu przechowywania danych. Zobacz Scopes .
Maksymalna liczba wpisów do zwrócenia. Usługa może zwrócić mniej niż wartość ten. Domyślną wartością jest 10 . Maksymalna wartość jest 100 , a każdy wpis ponad 100 jest zmuszony do 100 .
Token strony otrzymany z poprzedniego wezwania List. Dostarcz to, aby odzyskać następną stronę. Gdy paguje, wszystkie pozostałe parametry dostarczone dla List muszą zgadzać się z wezwaniem dostarczającym token strony.
Kierunek Sortowania. Domyślnie jest w górę. Wpisz desc zapisek dla Sortowania w dół.
Zakres kwalifikujących wartości wpisów do zwrócenia. 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ź:
Tworzyć
Tworzy nową pozycję z dostępną wartością treści.
Parametry
Zidentyfikator doświadczenia z przechowywanymi danymi, które chcesz uzyskać dostęp do. Zobacz identyfikator uniwersum na jakim sposób kopiować go na Creator Dashboard.
Nazwa przechowywanej danych.
Nazwa zakresu przechowywania danych. Zobacz Scopes .
Nazwa pozycji.
Tworzy nową pozycję z danymi dostarczonymi.
Żą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ź:
Zdobądź
Zdobywa i zwraca określony wpis.
Parametry
Zidentyfikator doświadczenia z przechowywanymi danymi, które chcesz uzyskać dostęp do. Zobacz identyfikator uniwersum na jakim sposób kopiować go na Creator Dashboard.
Nazwa przechowywanej danych.
Nazwa zakresu przechowywania danych. Zobacz Scopes .
ID zapisu.
Żą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ź:
Usuń
Usuwa określony wpis.
Parametry
Zidentyfikator doświadczenia z przechowywanymi danymi, które chcesz uzyskać dostęp do. Zobacz identyfikator uniwersum na jakim sposób kopiować go na Creator Dashboard.
Nazwa przechowywanej danych.
Nazwa zakresu przechowywania danych. Zobacz Scopes .
ID zapisu.
Żą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ź:
Aktualizacja
Aktualizuje wartość wpisu i zwraca aktualizowany wpis.
Parametry
Zidentyfikator doświadczenia z przechowywanymi danymi, które chcesz uzyskać dostęp do. Zobacz identyfikator uniwersum na jakim sposób kopiować go na Creator Dashboard.
Nazwa przechowywanej danych.
Nazwa zakresu przechowywania danych. Zobacz Scopes .
ID zapisu.
Aktualizuje wpis z nową wartością.
Flaga dozwalająca utworzenie wpisu, jeśli wpis nie istnieje. Zobacz Dozwól Missing Flags.
Żą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ź:
Przychód
Zwiększa wartość klucza o podanych kwotach i zwraca aktualizowaną pozycję.
Znany problem: wartości wpisu mogą przekroczyć zakres ważny, a ten stan trwa w tle. Zwrócone wartości będą skalibrowane na zakres ważny.
Parametry
Zidentyfikator doświadczenia z przechowywanymi danymi, które chcesz uzyskać dostęp do. Zobacz identyfikator uniwersum na jakim sposób kopiować go na Creator Dashboard.
Nazwa przechowywanej danych.
Nazwa zakresu przechowywania danych. Zobacz Scopes .
ID zapisu.
Zwiększa wartość wpisu.
Żą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ź:
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 danymi dostarczonymi.
Atrybuty
Wartość ustawienia nowego wpisu. Jeśli wartość wejścia przekracza maksymalną wartość wspieraną przez int64, która to 9,223,372,036,854,775,807, wniosek kończy się błędem 400 Bad Request.
Entry
Reprezentuje wejście.
Atrybuty
Nazwa pozycji
Droga zasobu prośba.
Wartość wpisu.
IncrementEntryRequest
Zwiększa wartość wpisu.
Atrybuty
Ilość do zwiększenia przez wartość wejścia. Jeśli wartość wejścia przekracza maksymalną wartość wspieraną przez int64, która jest 9 223 372 036 854 775 807, wniosek kończy się błędem 400 Bad Request.
ListEntriesResponse
Lista wpisów w kolekcjarodzicielskiej.
Atrybuty
Wejścia z określonego zakresu.
Token, który można wysłać jako page_token , aby odzyskać następną stronę. Jeśli tego pola zostanie pominięte, nie ma następnych stron.
UpdateEntryRequest
Aktualizuje wpis z nową wartością.
Atrybuty
Wartość do uaktualnienia zapisu. Jeśli wartość wejścia przekracza maksymalną wartość wspieraną przez int64, która to 9,223,372,036,854,775,807, wniosek kończy się błędem 400 Bad Request.