Almacenes de datos ordenados (Beta)
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Esta página incluye la documentación de referencia para trabajar con almacenes de datos ordenados. Para obtener más información sobre el uso de la API, see Manipulación de solicitudes de API para almacenes de datos y el Guía de uso .
OrderedDataStores
Lista
Devuelve una lista de entradas de un almacén de datos tienda.
Parámetros
El identificador de la experiencia con datos ordenados que quieres acceso. Ver ID del Universo en cómo copiarlo en Pantalla del Creador .
El nombre del tiendade datos ordenado de destino.
El nombre del alcance del almacén de datos. Ver Escalas .
El número máximo de entradas para devolver. El servicio puede devolver menos de este valor. El valor predeterminado es 10 . El valor máximo es 100 y cualquier entrada superior a 100 está obligada a 100 .
Un token de página recibido de una llamada anterior. Proporcione esto para recuperar la página siguiente. Cuando se paga, todos los demás parámetros proporcionados a List deben coincidir con la llamada que proporciona el token de página.
La dirección de la enumeración. La orden por defecto es ascender. Ingrese un desc sufijo para la descendencia.
El rango de valores de calificación de las entradas para devolver. Véase Filtros .
Solicitud
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'Respuesta
Crear
Crea una nueva entrada con el valor de contenido proporcionado.
Parámetros
El identificador de la experiencia con datos ordenados que quieres acceso. Ver ID del Universo en cómo copiarlo en Pantalla del Creador .
El nombre del tiendade datos pedido.
El nombre del alcance del almacén de datos. Ver Escalas .
El nombre de la entrada.
Crea una nueva entrada con el valor proporcionado.
Solicitud
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>
}'Respuesta
Obtener
Obtiene y devuelve la entrada especificada.
Parámetros
El identificador de la experiencia con datos ordenados que quieres acceso. Ver ID del Universo en cómo copiarlo en Pantalla del Creador .
El nombre del tiendade datos pedido.
El nombre del alcance del almacén de datos. Ver Escalas .
El ID de la entrada.
Solicitud
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>'Respuesta
Eliminar
Elimina la entrada especificada.
Parámetros
El identificador de la experiencia con datos ordenados que quieres acceso. Ver ID del Universo en cómo copiarlo en Pantalla del Creador .
El nombre del tiendade datos pedido.
El nombre del alcance del almacén de datos. Ver Escalas .
El ID de la entrada.
Solicitud
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>'Respuesta
Actualización
Actualiza un valor de entrada y devuelve el valor actualizado.
Parámetros
El identificador de la experiencia con datos ordenados que quieres acceso. Ver ID del Universo en cómo copiarlo en Pantalla del Creador .
El nombre del tiendade datos pedido.
El nombre del alcance del almacén de datos. Ver Escalas .
El ID de la entrada.
Actualiza la entrada proporcionada con un nuevo valor.
La bandera para permitir la creación de una entrada si la entrada no existe. Vea Permitir banderas no existentes .
Solicitud
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>
}'Respuesta
Incremento
Aumenta el valor de la llave en la cantidad proporcionada y devuelve la entrada actualizada.
Problema conocido: Los valores de entrada pueden incrementar más allá del rango válido y esto puede persistir en el backend. Los valores devueltos se ajustarán al rango válido.
Parámetros
El identificador de la experiencia con datos ordenados que quieres acceso. Ver ID del Universo en cómo copiarlo en Pantalla del Creador .
El nombre del tiendade datos pedido.
El nombre del alcance del almacén de datos. Ver Escalas .
El ID de la entrada.
Aumenta el valor de entrada.
Solicitud
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>
}'Respuesta
Objetos
Los siguientes objetos describen cargas que son aceptadas o devueltas. Ve cada extremo para más información sobre cuándo se utilizan estos objetos.
CreateEntryRequest
Crea una nueva entrada con el valor proporcionado.
Atributos
El valor para establecer la nueva entrada. Si el valor de entrada supera el máximo de valor admitido por int64, que es 9,223,372,036,854,775,807, la solicitud falla con un error de solicitud de 400.
Entry
Representa una entrada.
Atributos
El nombre de la entrada
El camino de recursos de la solicitud.
El valor de la entrada.
IncrementEntryRequest
Aumenta el valor de entrada.
Atributos
La cantidad a incrementar por el valor de entrada. Si el valor de entrada supera el valor máximo soportado por int64, que es 9,223,372,036,854,775,807, la solicitud falla con un error de solicitud 400.
ListEntriesResponse
Una lista de Entradas en la coleccionespadre.
Atributos
Las Entradas del alcance especificado.
Un token, que se puede enviar como page_token para recuperar la siguiente página. Si se omite este campo, no hay páginas siguientes.
UpdateEntryRequest
Actualiza la entrada proporcionada con un nuevo valor.
Atributos
El valor para actualizar la entrada. Si el valor de entrada supera el máximo de valor admitido por int64, que es 9,223,372,036,854,775,807, la solicitud falla con un error de solicitud de 400.