Armazenamentos de dados padrão
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Esta página inclui documentação de referência para trabalhar com armazenamentos de dados padrão.Para mais informações sobre o uso da API (Interface de Programação para Aplicações), veja lidar com solicitações de API para armazenamentos de dados e o guia de uso.
Datastores
Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.
Lista de armazenamentos de dados
Retorna uma lista de armazenamentos de dados de uma experiência.
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
Forneça para solicitar o próximo conjunto de dados. Veja Cursors.
O número máximo de itens a retornar.Cada chamada só lê uma partição, então ela pode retornar menos do que o valor dado quando ficar sem objetivos em uma partição.
Forneça para retornar apenas armazenamentos de dados com esse prefixo.
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Entries
Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.
Listar Entradas
Retorna uma lista de chaves de entrada dentro de um lojade dados.
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
O nome do armazenamento de dados.
O valor é global por padrão. Veja Escopos .
Defina como verdadeiro para retornar chaves de todos os escopos.
Forneça para retornar apenas chaves com esse prefixo.
Forneça para solicitar o próximo conjunto de dados. Veja Cursors.
O número máximo de itens a retornar.Cada chamada só lê uma partição, então ela pode retornar menos do que o valor dado quando ficar sem objetivos em uma partição.
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Obter Entrada
Retorna o valor e os metadados associados a uma entrada.
Metadados podem ser encontrados nos cabeçalhos de resposta como o seguindo:
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]
| Cabeceio | Descrição | |---|---| | content-md5 | O resumo MD5 codificado em base-64 do conteúdo.Veja Conteúdo-MD5.| | roblox-entry-version | A versão da entrada retornada.| | roblox-entry-created-time | A hora em que a entrada foi criada.| | roblox-entry-version-created-time | A hora em que esta versão específica foi criada.| | roblox-entry-attributes | Atributos rotulados com a entrada.Objeto de mapa JSON serializado.| | roblox-entry-userids | Lista separada por vírgula de IDs de usuário do Roblox marcados com a entrada. |
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
O nome do armazenamento de dados.
A chave que identifica a entrada.
O valor é global por padrão. Veja Escopos .
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Definir Entrada
Define o valor, metadados e IDs de usuário associados a uma entrada.
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
O nome do armazenamento de dados.
A chave que identifica a entrada.
Forneça para atualizar apenas se a versão atual corresponder a isso.
Crie a entrada somente se ela não existir.
O valor é global por padrão. Veja Escopos .
Atributos a serem associados à nova versão da entrada. Serializados por objetos de mapa JSON. Se não for fornecido, os atributos existentes são limpados.
Lista separada por vírgula de IDs de usuário do Roblox marcados com a entrada. Se não for fornecido, os IDs de usuário existentes são limpados.
O resumo de MD5 codificado em base-64 do conteúdo. Veja Conteúdo-MD5.
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Apagar Entrada
Marca a entrada como excluída ao criar uma versão de lápide. As entradas são excluídas permanentemente após 30 dias.
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
O nome do armazenamento de dados.
A chave que identifica a entrada.
O valor é global por padrão. Veja Escopos .
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Entrada de Incremento
Aumenta o valor para uma entrada em uma quantia dada ou cria uma nova entrada com essa quantia. Retorna a entrada e o metadado.
Metadados podem ser encontrados nos cabeçalhos de resposta como o seguindo:
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]
| Cabeceio | Descrição | |---|---| | content-md5 | O resumo MD5 codificado em base-64 do conteúdo.Veja Conteúdo-MD5.| | roblox-entry-version | A versão da entrada retornada.| | roblox-entry-created-time | A hora em que a entrada foi criada.| | roblox-entry-version-created-time | A hora em que esta versão específica foi criada.| | roblox-entry-attributes | Atributos rotulados com a entrada.Objeto de mapa JSON serializado.| | roblox-entry-userids | Lista separada por vírgula de IDs de usuário do Roblox marcados com a entrada. |
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
O nome do armazenamento de dados.
A chave que identifica a entrada.
A quantidade pelo qual a entrada deve ser incrementada ou o valor inicial se não existir.
O valor é global por padrão. Veja Escopos .
Atributos a serem associados à nova versão da entrada. Serializados por objetos de mapa JSON. Se não for fornecido, os atributos existentes são limpados.
Uma lista separada por vírgula de IDs de usuário do Roblox com os quais a entrada é marcada. Se não for fornecida, os IDs de usuário existentes são limpados.
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Obtenha a versão de entrada
Retorna o valor e os metadados de uma versão específica de uma entrada.
Metadados podem ser encontrados nos cabeçalhos de resposta como o seguindo:
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]
| Cabeceio | Descrição | |---|---| | content-md5 | O resumo MD5 codificado em base-64 do conteúdo.Veja Conteúdo-MD5.| | roblox-entry-version | A versão da entrada retornada.| | roblox-entry-created-time | A hora em que a entrada foi criada.| | roblox-entry-version-created-time | A hora em que esta versão específica foi criada.| | roblox-entry-attributes | Atributos rotulados com a entrada.Objeto de mapa JSON serializado.| | roblox-entry-userids | Lista separada por vírgula de IDs de usuário do Roblox marcados com a entrada. |
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
O nome do armazenamento de dados.
A chave que identifica a entrada.
A versão para inspecionar.
O valor é global por padrão. Veja Escopos .
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Limites
Por chave de API: 5000 solicitações a cada 60 segundos por endereço IP
Listar Versões de Entrada
Retorna uma lista de versões para uma entrada.
Parâmetros
O identificador da experiência com armazenamentos de dados que você deseja acesso.Você pode copiar o ID do Universo da sua experiência no Painel do Criador .
O nome do armazenamento de dados.
A chave que identifica a entrada.
O valor é global por padrão. Veja Escopos .
Forneça para solicitar o próximo conjunto de dados (veja Cursors).
Forneça para não incluir versões anteriores a este timestamp.
Forneça para não incluir versões posteriores a esse timestamp.
Ou Ascending (versões anteriores primeiro) ou Descending (versões posteriores primeiro).
O número máximo de itens a retornar.Cada chamada só lê uma partição, então ela pode retornar menos do que o valor dado quando ficar sem objetivos em uma partição.
Solicitação
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"
Resposta
Permissões necessárias
As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.
Objetos
Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.
DataStore
O objeto armazenamento de dados com seu nome e tempo de criação.
Atributos
O nome do seu lojade dados.
O timestamp de quando o armazenamento de dados foi criado no formato de tempo ISO.
EntryVersion
O objeto de versão de entrada retornado pelo método List Entry Versions.
Atributos
O nome da versão da entrada qualificada.
Indica se a entrada foi excluída.
O comprimento do conteúdo.
O horário de quando a versão foi criada no formato de tempo da ISO.
O timestamp de quando o armazenamento de dados foi criado no formato de tempo ISO.