Magazzini di dati ordinati (beta)
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Questa pagina include la documentazione di riferimento per lavorare con store di dati ordinati.Per ulteriori informazioni sull'utilizzo dell'API, vedi Gestisci richieste API per archivi di dati e la guida all'uso.
OrderedDataStores
Lista
Restituisce un elenco di voci da un data Negozioordinato.
Parametri
L'identificatore dell'esperienza con store di dati ordinati a cui vuoi Accesso.Vedi ID Universo su come copiarlo su Dashboard Creatore.
Il nome del data Negozioordinato target.
Il nome dello scope del data store. Vedi Scope.
Il numero massimo di voci da Riportare.Il servizio può restituire meno di questo valore.Il valore predefinito è 10 .Il valore massimo è 100 , e qualsiasi input sopra 100 è costretto a 100 .
Un token di pagina ricevuto da una chiamata precedente List .Fornisci questo per recuperare la pagina successiva.Durante la paginazione, tutti gli altri parametri forniti a List devono corrispondere alla chiamata che fornisce il token della pagina.
La direzione di enumerazione. L'ordine predefinito è ascendente. Inserisci un suffisso desc per discesa.
La gamma di valori di qualificazione delle entrate da Riportare. Vedi Filtri .
Richiesta
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'Risposta
Permessi Necessari
Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi Gestisci chiavi API.
Crea
Crea una nuova voce con il valore del contenuto fornito.
Parametri
L'identificatore dell'esperienza con store di dati ordinati a cui vuoi Accesso.Vedi ID Universo su come copiarlo su Dashboard Creatore.
Il nome del data Negozioordinato.
Il nome dello scope del data store. Vedi Scope.
Il nome dell'elemento.
Richiesta
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>
}'Risposta
Permessi Necessari
Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi Gestisci chiavi API.
Ottieni
Ottiene e restituisce l'elemento specificato.
Parametri
L'identificatore dell'esperienza con store di dati ordinati a cui vuoi Accesso.Vedi ID Universo su come copiarlo su Dashboard Creatore.
Il nome del data Negozioordinato.
Il nome dello scope del data store. Vedi Scope.
L'ID di ingresso.
Richiesta
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>'Risposta
Permessi Necessari
Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi Gestisci chiavi API.
Elimina
Elimina l'elemento specificato.
Parametri
L'identificatore dell'esperienza con store di dati ordinati a cui vuoi Accesso.Vedi ID Universo su come copiarlo su Dashboard Creatore.
Il nome del data Negozioordinato.
Il nome dello scope del data store. Vedi Scope.
L'ID di ingresso.
Richiesta
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>'Risposta
Permessi Necessari
Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi Gestisci chiavi API.
Aggiorna
Aggiorna un valore di ingresso e restituisce l'ingresso aggiornato.
Parametri
L'identificatore dell'esperienza con store di dati ordinati a cui vuoi Accesso.Vedi ID Universo su come copiarlo su Dashboard Creatore.
Il nome del data Negozioordinato.
Il nome dello scope del data store. Vedi Scope.
L'ID di ingresso.
La bandiera per consentire la creazione di un'entrata se l'entrata non esiste. Vedi Consenti bandiere mancanti .
Richiesta
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>
}'Risposta
Permessi Necessari
Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi Gestisci chiavi API.
Incremento
Aumenta il valore della chiave dell'importo fornito e restituisce l'elemento aggiornato.
Problema noto: i valori di ingresso possono incrementare oltre il raggio valido e questo può persistere nel backend. I valori restituiti si agganceranno al raggio valido.
Parametri
L'identificatore dell'esperienza con store di dati ordinati a cui vuoi Accesso.Vedi ID Universo su come copiarlo su Dashboard Creatore.
Il nome del data Negozioordinato.
Il nome dello scope del data store. Vedi Scope.
L'ID di ingresso.
Richiesta
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>
}'Risposta
Permessi Necessari
Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi Gestisci chiavi API.
Oggetti
Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.
CreateEntryRequest
Crea una nuova entry con il valore fornito.
Attributi
Il valore per impostare la nuova entry.Se il valore di input supera il valore massimo supportato da int64, che è 9,223,372,036,854,775,807, la richiesta fallisce con un errore 400 Bad Request.
Entry
Rappresenta un'entrata.
Attributi
Il nome dell'entrata
Il percorso delle risorse della Richiesta.
Il valore dell'entrata.
IncrementEntryRequest
Aumenta il valore di ingresso.
Attributi
L'importo da aumentare con il valore di ingresso.Se il valore di input supera il valore massimo supportato da int64, che è 9,223,372,036,854,775,807, la richiesta fallisce con un errore 400 Bad Request.
ListEntriesResponse
Un elenco di voci nella Collezionipadre.
Attributi
Le voci dalla scala specificata.
Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.
UpdateEntryRequest
Aggiorna l'elemento fornito con un nuovo valore.
Attributi
Il valore per aggiornare l'elemento.Se il valore di input supera il valore massimo supportato da int64, che è 9,223,372,036,854,775,807, la richiesta fallisce con un errore 400 Bad Request.