Almacenes de datos estándar
*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 documentación de referencia para trabajar con almacenes de datos estándar.Para obtener más información sobre el uso de la API, consulte manejar solicitudes de API para almacenamientos de datos y la guía de uso.
Datastores
Los siguientes extremos están disponibles en rutas relativas a la URL base.
Almacenes de datos de lista
Devuelve una lista de almacenes de datos de una experiencia.
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
Proporcione para solicitar el próximo conjunto de datos. Vea Cursores.
El número máximo de artículos para devolver.Cada llamada solo lee una partición, por lo que puede devolver menos que el valor dado cuando se agoten los objetivos en una partición.
Proporcionar para devolver solo almacenes de datos con este prefijo.
Solicitud
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "prefix=Player" \
-d "limit=5"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
Entries
Los siguientes extremos están disponibles en rutas relativas a la URL base.
Listar entradas
Devuelve una lista de claves de entrada dentro de un tiendade datos.
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
El nombre del tiendade datos.
El valor es global por defecto. Vea Ámbitos .
Establezca en verdadero para devolver las claves de todos los alcances.
Proporcionar para devolver solo claves con este prefijo.
Proporcione para solicitar el próximo conjunto de datos. Vea Cursores.
El número máximo de artículos para devolver.Cada llamada solo lee una partición, por lo que puede devolver menos que el valor dado cuando se agoten los objetivos en una partición.
Solicitud
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "prefix=" \
-d "limit=5"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
Obtener entrada
Devuelve el valor y el metadato asociado a una entrada.
Los metadatos se pueden encontrar en los encabezados de respuesta como lo siguiendo:
content-md5: zuYxEhwuySMv0i8CitXImw==roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-attributes: { "myAttribute": "myValue" }roblox-entry-userids: [1, 2, 3]
| Encabezado | Descripción | |---|---| | content-md5 | La suma de control MD5 codificada en base-64 del contenido.Vea Contenido-MD5.| | roblox-entry-version | La versión de la entrada devuelta.| | roblox-entry-created-time | El tiempo en el que se creó la entrada.| | roblox-entry-version-created-time | El tiempo en el que se creó esta versión en particular.| | roblox-entry-attributes | Atributos etiquetados con la entrada.objetode mapa JSON serializado.| | roblox-entry-userids | Lista separada por comas de ID de usuario de Roblox etiquetados con la entrada. |
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
El nombre del tiendade datos.
La clave que identifica la entrada.
El valor es global por defecto. Vea Ámbitos .
Solicitud
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
Establecer entrada
Establece el valor, los metadatos y las ID de usuario asociados con una entrada.
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
El nombre del tiendade datos.
La clave que identifica la entrada.
Proporcione actualizar solo si la versión actual coincide con esto.
Crea la entrada solo si no existe.
El valor es global por defecto. Vea Ámbitos .
Atributos que deben asociarse con la nueva versión de la entrada. Serializado por objetos de mapa JSON. Si no se proporciona, se eliminan los atributos existentes.
Lista separada por comas de ID de usuario de Roblox etiquetados con la entrada. Si no se proporciona, se eliminan los ID de usuario existentes.
El resumen de MD5 codificado en base-64 del contenido. Vea Contenido-MD5.
Solicitud
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry?datastoreName=Coins&entryKey=269323" \
--header "x-api-key: ${API_KEY}" \
--header "content-md5: IGPBYI1uC6+AJJxC4r5YBA==" \
--header "content-type: application/json" \
--header "roblox-entry-userids: [269323]" \
--header "roblox-entry-attributes: {}" \
--d "value"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
Eliminar entrada
Marca la entrada como eliminada al crear una versión de lápida. Las entradas se eliminan permanentemente después de 30 días.
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
El nombre del tiendade datos.
La clave que identifica la entrada.
El valor es global por defecto. Vea Ámbitos .
Solicitud
curl --include --location --request DELETE "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
Entrada de incremento
Incrementa el valor de una entrada en una cantidad determinada o crea una nueva entrada con esa cantidad. Devuelve la entrada y el metadato.
Los metadatos se pueden encontrar en los encabezados de respuesta como lo siguiendo:
content-md5: zuYxEhwuySMv0i8CitXImw==roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-attributes: { "myAttribute": "myValue" }roblox-entry-userids: [1, 2, 3]
| Encabezado | Descripción | |---|---| | content-md5 | La suma de control MD5 codificada en base-64 del contenido.Vea Contenido-MD5.| | roblox-entry-version | La versión de la entrada devuelta.| | roblox-entry-created-time | El tiempo en el que se creó la entrada.| | roblox-entry-version-created-time | El tiempo en el que se creó esta versión en particular.| | roblox-entry-attributes | Atributos etiquetados con la entrada.objetode mapa JSON serializado.| | roblox-entry-userids | Lista separada por comas de ID de usuario de Roblox etiquetados con la entrada. |
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
El nombre del tiendade datos.
La clave que identifica la entrada.
La cantidad por la cual debe incrementarse la entrada o el valor inicial si no existe.
El valor es global por defecto. Vea Ámbitos .
Atributos que deben asociarse con la nueva versión de la entrada. Serializado por objetos de mapa JSON. Si no se proporciona, se eliminan los atributos existentes.
Una lista separada por comas de ID de usuario de Roblox con los que la entrada está etiquetada. Si no se proporciona, se eliminan los ID de usuario existentes.
Solicitud
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/increment" \
--header "x-api-key: ${API_KEY}" \
--header 'content-length: 0' \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323" \
-d "incrementBy=3"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
Obtener la versión de entrada
Devuelve el valor y el metadato de una versión específica de una entrada.
Los metadatos se pueden encontrar en los encabezados de respuesta como lo siguiendo:
content-md5: zuYxEhwuySMv0i8CitXImw==roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-attributes: { "myAttribute": "myValue" }roblox-entry-userids: [1, 2, 3]
| Encabezado | Descripción | |---|---| | content-md5 | La suma de control MD5 codificada en base-64 del contenido.Vea Contenido-MD5.| | roblox-entry-version | La versión de la entrada devuelta.| | roblox-entry-created-time | El tiempo en el que se creó la entrada.| | roblox-entry-version-created-time | El tiempo en el que se creó esta versión en particular.| | roblox-entry-attributes | Atributos etiquetados con la entrada.objetode mapa JSON serializado.| | roblox-entry-userids | Lista separada por comas de ID de usuario de Roblox etiquetados con la entrada. |
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
El nombre del tiendade datos.
La clave que identifica la entrada.
La versión para inspeccionar.
El valor es global por defecto. Vea Ámbitos .
Solicitud
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions/version" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323" \
-d "versionId=08D9E6A3F2188CFF.0000000003.08D9E6DE485A7680.01"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
Límites
Por clave API: 5000 solicitudes cada 60 segundos por dirección IP
Versiones de entrada de lista
Devuelve una lista de versiones para una entrada.
Parámetros
El identificador de la experiencia con almacenes de datos a los que desea acceso.Puedes copiar la ID del universo de tu experiencia en el tablero de creación .
El nombre del tiendade datos.
La clave que identifica la entrada.
El valor es global por defecto. Vea Ámbitos .
Proporcionar para solicitar el siguiente conjunto de datos (ver cursor ).
Proporcione para que no se incluyan versiones anteriores a esta fecha y hora.
Proporcione para que no se incluyan versiones posteriores a esta fecha y hora.
O bien Ascending (versiones anteriores primero) o Descending (versiones posteriores primero).
El número máximo de artículos para devolver.Cada llamada solo lee una partición, por lo que puede devolver menos que el valor dado cuando se agoten los objetivos en una partición.
Solicitud
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323" \
-d "limit=5"
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
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.
DataStore
El objeto almacén de datos con su nombre y tiempo de creación.
Atributos
El nombre de tu tiendade datos.
La marca de tiempo de cuando se creó el almacén de datos en el formato de tiempo ISO.
EntryVersion
El objeto de versión de entrada devuelto por el método List Entry Versions.
Atributos
El nombre de la versión de la entrada calificada.
Indica si la entrada ha sido eliminada.
La longitud del contenido.
La fecha y hora de creación de la versión en el formato de tiempo ISO.
La marca de tiempo de cuando se creó el almacén de datos en el formato de tiempo ISO.