*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

OrderedDataStoreEntry

Un'entrata chiave-valore in un archivio dati ordinato.

Attributi

pathstring

Il percorso risorsa dell'elemento del data store ordinato.

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

valuenumber

Il valore dell'entrata.

Sempre arrotondato all'intero più vicino.

idstring
Solo output

Il nome dell'elemento.

URL di base
https://apis.roblox.com
Risorsa 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

Elenca gli elementi del magazzino dati ordinati
Beta

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

Restituisce un elenco di voci da un data store ordinato.

Campi
universe.ordered-data-store.scope.entry:read
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

ordered_data_store_idstring
Necessario

L'ID del negozio di dati ordinato.

scope_idstring
Necessario

L'ID della portata.

Parametri query
maxPageSizenumber

Il numero massimo di entrate del data store ordinato da restituire.Il servizio potrebbe restituire meno di questo valore.Se non specificato, a massimo 10 vengono restituiti ingressi di archiviazione dati ordinati.Il valore massimo è 100 e i valori più alti sono impostati su 100.

pageTokenstring

Un token di pagina, ricevuto da una chiamata precedente, per recuperare una pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti alla chiamata successiva devono corrispondere alla chiamata che ha fornito il token della pagina.

orderBystring

Se specificato, i risultati sono ordinati in base ai campi specificati.

I valori devono essere una lista separata da virgola di campi, con un prefisso "desc" opzionale per campo per ordinare in ordine discendente piuttosto che ascendente.Puoi accedere ai sottocampi con un operatore ..

I risultati possono essere ordinati dai seguenti campi: valore.

Esempio: "value desc".

filterstring

Questo campo può essere impostato per filtrare le risorse restituite.

Supportiamo due operatori di confronto per questa operazione: <= e >=.Questi operatori di confronto agiscono come minValue e maxValue per i valori restituiti.Se è necessaria la filtrazione per un valore tra un minValue e un maxValue, l'utente può utilizzare l'operatore logico &&.Tutti i token nell'espressione del filtro devono essere separati da un singolo spazio.

Esempi di filtri: entry <= 10 ; entry >= 10 && entry <= 30.

Risposta

Un elenco di OrderedDataStoreEntries nella collezione padre.

orderedDataStoreEntriesarray<OrderedDataStoreEntry>

Gli OrderedDataStoreEntries dal campo specificato OrderedDataStoreScope.

nextPageTokenstring

Un token che puoi inviare come parametro pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.

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}'
Risposta
{

  "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

Crea un'entrata del Data Store ordinata
Beta

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

Crea un'entrata con l'ID e il valore forniti.

Restituisce una richiesta 400 se l'entrata esiste.

Campi
universe.ordered-data-store.scope.entry:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

ordered_data_store_idstring
Necessario

L'ID del negozio di dati ordinato.

scope_idstring
Necessario

L'ID della portata.

Parametri query
idstring

L'ID da utilizzare per l'inserimento del data store ordinato, che diventerà il percorso di risorse finale dell'inserimento del data store ordinato.

Questo valore dovrebbe essere una stringa di caratteri A 1-63. Consigliamo vivamente di utilizzare solo lettere minuscole, numeri e trattini.

Corpo della richiestaOrderedDataStoreEntry
RispostaOrderedDataStoreEntry
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"

}'
Risposta
{

  "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

Ottieni l'ingresso nel negozio di dati ordinati
Beta

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

Ottiene l'entrata specificata.

Campi
universe.ordered-data-store.scope.entry:read
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

ordered_data_store_idstring
Necessario

L'ID del negozio di dati ordinato.

scope_idstring
Necessario

L'ID della portata.

entry_idstring
Necessario

L'ID di ingresso.

RispostaOrderedDataStoreEntry
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}'
Risposta
{

  "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

Elimina l'elemento del magazzino dati ordinato
Beta

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

Elimina l'elemento specificato.

In caso di successo, restituisce 200 OK. Se l'entrata non esiste, restituisce 404 Non trovato.

Campi
universe.ordered-data-store.scope.entry:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

ordered_data_store_idstring
Necessario

L'ID del negozio di dati ordinato.

scope_idstring
Necessario

L'ID della portata.

entry_idstring
Necessario

L'ID di ingresso.

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

Aggiorna l'elemento del negozio di dati ordinati
Beta

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

Aggiorna il valore di un'entrata.

Campi
universe.ordered-data-store.scope.entry:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

ordered_data_store_idstring
Necessario

L'ID del negozio di dati ordinato.

scope_idstring
Necessario

L'ID della portata.

entry_idstring
Necessario

L'ID di ingresso.

Parametri query
allowMissingboolean

Se impostato su vero e l'elemento del data store ordinato non viene trovato, viene creato un elemento del data store ordinato.

Corpo della richiestaOrderedDataStoreEntry
RispostaOrderedDataStoreEntry
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"

}'
Risposta
{

  "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

Incremento dell'ordine del Data Store ordinato
Beta

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

Aumenta il valore dell'elemento specificato. Sia il valore esistente che l'importo dell'incremento devono essere interi.

Se l'elemento non esiste, crea un elemento con il valore specificato.

Problema noto: il valore può essere aumentato oltre il range valido di valori.Quando ciò accade, il valore restituito verrà limitato all'intervallo valido, ma il backend può persistere nel valore originale.Questo comportamento viene mantenuto per motivi di compatibilità retrospettiva, ma potrebbe cambiare in una futura versione di questa API.

Campi
universe.ordered-data-store.scope.entry:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

ordered_data_store_idstring
Necessario

L'ID del negozio di dati ordinato.

scope_idstring
Necessario

L'ID della portata.

entry_idstring
Necessario

L'ID di ingresso.

Corpo della richiesta
amountnumber

L'importo con cui aumentare il valore di ingresso. Sia il valore esistente che l'importo di incremento devono essere interi.

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

}'
Risposta
{

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

}