HTTP APIs for working with users on Roblox Cloud, including inventory items, restrictions, subscriptions, and more.

Open Cloud APIs

Open Cloud v2

Followings

Legacy APIs

Users

Visão geral

Experiências

Avatar

Ativos

Nuvem aberta

Criação

Descoberta

Localização

Dados analíticos

Design

Dimensionamento

Monetização

Education

Este método é assíncrono e retorna uma "Operação", que representa o estado atual da operação. Ele contém um caminho de endpoint que você pode solicitar para obter a resposta real e os metadados aplicáveis. Veja o [documentation]({longRunningOperationsLink}) em operações de longo prazo para obter mais informações.
            
As seções a seguir descrevem os objetos de resposta e metadados que são fornecidos quando uma operação se completa.

Pontos de extremidade beta estão prontos para uso público. Alterações  danosas são possíveis mas raras.

Este campo pode ser definido ao criar um recurso, mas não pode ser modificado por solicitações subsequentes.

Esses campos podem ser definidos ao criar um recurso, mas não podem ser modificados por solicitações subsequentes.

Este campo pode ser fornecido em solicitações, mas nunca será incluído em respostas.

Por chave de API: {maxInPeriod} solicitações a cada {periodInSeconds} segundos por endereço IP

Este campo pode ser definido como respostas, mas será ignorado em solicitações.

Nota: Os limites de taxa podem ser menores durante períodos de alto tráfego. Alguns pontos de extremidade têm limites de taxa adicionais. [Saiba mais sobre os limites da taxa]({link}).

{limit} solicitações por segundo em todas as chaves API para um usuário ou grupo

{limit} solicitações por hora em todas as chaves API para um usuário ou grupo

{limit} solicitações por segundo em todas as chaves de API para um usuário ou grupo

{limit} solicitações por minuto por proprietário de chave API

{limit} solicitações por dia por usuário do aplicativo

{limit} solicitações por hora por usuário do aplicativo

{limit} solicitações por minuto por usuário do aplicativo

{limit} solicitações por segundo por usuário do aplicativo

{limit} solicitações por segundo por proprietário de chave API

Scopes control what permissions your credentials have. Your credentials can only access the endpoints supported by the scopes you selected.

This target enables you to limit your key's access to selected {requiredParts}

This target enables you to limit your key's access to selected {requiredParts} and {optionalParts}

Target types are used to restrict the resources that your credentials have permissions on. Only the selected resources can be acted on even if your account has permissions on additional resources. Some scopes do not have target parts. In these cases, all of your relevant resources can be acted on.

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]({apiKeyReferenceDocLink}).

Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.

Esta cadeia de caracteres está formatada como um [FieldMask](/cloud/reference/types#fieldmask).

Um valor JSON pode ser `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Os seguintes escopos são necessários para que seu aplicativo OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão de aplicativos]({oauth2ReferenceDocLink}).

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.

Esta cadeia de caracteres é formatada como um [Timestamp](/cloud/reference/types#timestamp).

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão do aplicativo]({oauth2ReferenceDocLink}).

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

Isso permite conceder permissões de ativos a todos os participantes (incluindo grupos e experiências) e aos ativos que sua conta tem acesso.

Concede a capacidade de atualizar emblemas de propriedade do usuário.

Isso permite visualizar informações sobre seus itens de comércio.

Isso permite fazer alterações nos itens de comércio sincronizados.

This allows viewing information about your commerce merchant connections.

Isso permite editar suas conexões de comerciante.

Isso permite que você visualize informações sobre seus produtos da Loja do Criador.

Isso permite que você modifique informações sobre seus produtos da Loja de Criadores.

Grants access to create data stores on your behalf.

Grants access to read a list of data stores.

Grants access to take a snapshot of your data stores.

Grants access to create entries in your data stores.

Grants access to mark specified entries for deletion.

Grants access to list your data store's entries.

Grants access to read specified entries in your data stores.

Grants access to update the value, attributes, and users of an entry.

Grants access to delete revisions of your data store's entries.

Grants access to list revisions for your data store's entries.

Grants access to read revisions of your data store's entries.

Isso permite visualizar informações sobre suas comunidades

Isso permite que você gerencie solicitações de participação na comunidade e atualizações de cargos de membros da comunidade de níveis inferiores para sua conta.

Permite que você veja os dados da instância de propriedade.

Permite modificar os dados de propriedade de instâncias (atualmente suporta apenas scripts).

Isto permite visualizar informações sobre seu inventário.

Conceda acesso para gerenciar seus ativos.

Concede acesso para gerenciar seus emblemas.

Concede acesso para gerenciar seus emblemas e gastar Robux.

Concede acesso para gerenciar seus produtos de desenvolvedor.

Concede acesso para ler informações sobre as experiências nas quais você tem notificações ligadas.

Concede acesso às notificações para as experiências em seu nome.

Concede acesso para gerenciar seus passes.

Concede acesso para gerenciar suas comunidades.

Concede permissão para ler informações da comunidade.

Concede permissões de gerenciamento de comunidade.

Concede acesso para ler e escrever suas tabelas de localização

Concede acesso para gerenciar a colaboração de equipe para todas as experiências que você possui.

Concede acesso para gerenciar suas experiências e certas informações associadas a suas experiências (por exemplo, informações de localização).

Concede acesso para ler as informações de localização das suas experiências.

Concede acesso para modificar as preferências de localização das suas experiências.

Concede acesso para gerenciar sua conta de usuário.

Concede acesso para modificar as preferências de localização do usuário.

Permite que você veja o status, registros e resultados de tarefas de execução Luau para o local associado.

Permite criar novas tarefas de execução Luau para o lugar associado.

Concede acesso a liberar assíncronamente todas as estruturas de dados no universo.

Concede acesso para criar novos itens da fila.

Concede acesso para descartar itens lidos do começo da fila.

Concede acesso para ler itens no começo da fila.

Concede acesso para ler os itens do armazenamento de memória.

Concede acesso para criar, atualizar e excluir itens de mapa.

Isto permite publicar mensagens em nome de um usuário.

Isto permite o envio de notificações da sua experiência aos usuários.

(Deprecated) Grants access to read a list of entries in an ordered data store.

(Deprecated) Grants access to create a new entry in an ordered data store.

Grants access to list entries from an ordered data store.

Grants access to create entries in an ordered data store.

Isto permite listar segredos aliados à sua experiência.

Isto permite criar e atualizar segredos relacionados à sua experiência.

Esta permissão permite que você envie um trabalho de avaliação e visualize o resultado da tarefa.

Concede acesso para ler sobre seus produtos de assinatura.

Concede a capacidade de ler informações do local.

Concede a capacidade de editar as informações do local.

Esta operação permite acesso para publicar novas versões de experiências para a Roblox.

Concede a capacidade de ler informações da experiência.

Concede a capacidade de editar informações da experiência.

Permite que você veja restrições de usuário na experiência.

Permite que você edite restrições de usuário na experiência.

Concede a capacidade de ler o status Premium e verificado do usuário.

Isso permite que você veja as contas sociais de um usuário.

Isto habilita a funcionalidade de entrada única.

Isso permite acesso à leitura das informações do seu perfil.

Essa função retorna imediatamente, se possível, mas pode gerar a sequência que a chamou até que possa retornar um valor.

{nameStart}nome{nameEnd} não é mais suportado ou mantido pela Roblox.

Essa operação matemática não é mais suportada ou mantida pela Roblox.

Este membro não aparece no navegador de objetos e não é para uso geral.

Este membro só é acessível somente através da barra de comandos. Tentar acessar este membro a partir de scripts causa um erro.

Esta função não pode pausar o tópico Lua que a chamou.

Tentar acessar este membro em scripts causa um erro. Você pode ser capaz de acessar este membro na janela de propriedades do Roblox Studio.

Este membro não aparece no Navegador de Objetos do Roblox Studio.

Não é possível criar uma instância desta classe com o construtor Instance.new.

A Roblox não replica este membro além do limite do seu servidor-cliente.

O código Lua não pode acessar este membro. Você pode ser capaz de alterar o valor dele na janela de propriedades do Roblox Studio.

Este membro está acessível a partir das tarefas de execução do OpenCloud Luau.

O comportamento de replicação do objeto depende do jogador que o possui.

Este membro é acessível somente através da barra de comandos e plugins. Tentar acessar este membro a partir de scripts causa um erro.

Este membro é somente leitura. Tentar escrever para este membro causa um erro.

Esta propriedade é somente leitura e é segura para ler em tópicos não sincronizados. Tentar escrever nela causa um erro.

Esta propriedade é somente leitura e é segura para ler em threads não sincronizadas. Tentar escrever nela causa um erro.

Este membro é acessível somente no CoreScripts.

Somente o Roblox CoreScripts pode acessar este membro e ele não é utilizável por jogadores.

Você pode ler e escrever para esta propriedade com segurança a partir de várias threads.

Esta classe é uma singleton de alto nível. Recupere uma instância desta classe com a função GetService.

Várias threads podem potencialmente escrever para esta propriedade, então não é seguro ler a partir de threads não sincronizadas.

Você pode ler e escrever para esta propriedade com segurança a partir de vários tópicos.

Esta função pausa a thread Lua que a chamou até que ela retorne um resultado. Isto não interrompe outros scripts.

Gerencie e analise todas as suas experiências em um único lugar conveniente.

Aprenda com a documentação e recursos para todos os criadores.

Aprenda a criar experiências Roblox com guias, tutoriais e amostras de código.

Construa suas experiências no Studio, nosso ambiente de desenvolvimento integrado (também chamado pela sigla em inglês IDE) e distribua-as para uma grande variedade de dispositivos.

Maneiras confiáveis de oferecer valor ao longo do tempo ao seu público

Desde março a maioria dos criadores que usaram o novo Gerenciador de anúncios experimentou uma queda de 44% no custo por jogada e um aumento de 89% nas taxas de qualidade de jogabilidade.

Aprenda a criar anúncios de sucesso que geram tráfego para suas criações

Trace o crescimento da sua experiência e descubra oportunidades para melhorar

Aprenda a aplicar movimento aos seus personagens e ambientes

Aprenda como fazer upload ou usar ativos da Loja em suas criações

Criar itens de avatar e publicá-los no mercado

Ordenado pela maior renda nos últimos 7 dias

Aprenda sobre o que você pode fazer e vender no mercado

O avatar representa cada usuário da Roblox como um personagem personalizável

Gerencie suas proibições permanentes e temporárias do na Central de Criadores.

Veja este tópico de criações legais sendo construídas pela comunidade

Aprenda técnicas básicas de modelagem no Blender

Encontre modelos, scripts e plugins feitos por outros criadores

Aprenda como criar gaiolas para seus itens de avatar com um artista 3D da Roblox

Aprenda como configurar personagens para garantir que todas as funções do avatar funcionem corretamente

Aprenda a criar objetos que interagem com o mundo ou com outros usuários

Faça e venda seu primeiro item básico de roupa na Roblox

Use as ferramentas de colaboração do Studio para trabalhar com sua equipe ao mesmo tempo

Veja o que está em alta no Mercado de Criações

Confira o que está em alta na Loja do Criador

Participe de eventos comunitários realizados por outros criadores

Encontre tutoriais escritos pela comunidade de criadores

Saiba como implementar um sistema de recompensa de convite de conexão

Mantenha os jogadores engajados e monetizados com atualizações de conteúdo

Capture seu público com um ciclo de jogabilidade agradável

Impulsione o engajamento e o progresso com uma jogabilidade divertida e repetitiva

Comece sua jornada de criador fazendo o seu primeiro local.

Aprenda a criar uma porta deslizante sem escrever nenhum código

Alex compartilha a experiência em primeira mão por trás da criação da experiência de sucesso, JailBreak

Blake encontrou uma paixão em fazer jogos de parques de diversão realistas e extravagantes

The Clemens é o estúdio de propriedade da família por trás de sucessos como O Jogo de Sobrevivência

Jasmine é a artista por trás de alguns dos itens de avatar mais populares no Mercado

Jessica é a designer por trás dos ambientes imaginativos de jogos, como no Alo Yoga

Jenni é o criador e artista de CGUs por trás de muitas colaborações populares

O estilo único do Morphist combina estética fofa e emo

Os criadores do Riotfall viajam para encontrar inspiração para seus ambientes imersivos

Stephen compartilha seu amor por ferramentas de programação

Sam compartilha como eles começaram a projetar itens de moda que eles gostariam que existissem

Todos os objetos que compõem um mundo 3D, como peças e iluminação

Use armazenamento de dados para salvar o progresso do jogador e lidar com a posição do jogador.

Aprenda sobre a gama de ferramentas de depuração disponíveis no Studio

Veja seu progresso em direção ao seu próximo saque!

Use o console do desenvolvedor para depurar sua experiência ao testar

Adicionar assinaturas à sua experiência ajuda a construir relacionamentos a longo prazo com sua base de usuários. Habilite assinaturas antes de 15 de dezembro de 2023 e desfrute de 3 meses de taxas mais baixas.

Visite as principais experiências para obter inspiração

Comece com o Studio, o motor de criação da Roblox

Adicione algumas linhas de código para desbloquear novos painéis para entender sua integração e outros funis e acompanhar sua economia no jogo.

A Minty ensina o Enyu sobre geometria sólida construtiva.

Construa eventos ao vivo, entre servidores e cenas em uma sequência estruturada

Aprenda a criar eventos temporizados para suas experiências

Crie eventos baseados no tempo para aumentar a visibilidade no Roblox. Anuncie sua última atualização, destaque uma atividade ou celebre um marco com seus jogadores!

Saiba como direcionar o grupo etário para a sua criação através das diretrizes de experienciados

Ganhe conhecimento e experiência diretamente da Roblox

Saiba como implementar um sistema de recompensa de convite de amigos

Aprenda como você pode controlar como seus dados são usados para treinar IA. {linkStart}Leia Mais{linkEnd}

Crie texturas personalizadas facilmente usando nossas ferramentas de IA

Use nosso motor de criação tudo-em-um para construir qualquer coisa que você possa imaginar

PolarCub compartilha todas as dicas e truques para fazer itens CGU

Aprenda as melhores práticas para bloquear seus ambientes.

Use o Guilded para construir uma comunidade para sua criação

Junte-se ao nosso incrível elenco de criadores para uma Game Jam do Dia das Bruxas

Use a parte da cabeça para criar animações faciais ou ativar emotes

Usando métricas para entender onde você pode melhorar sua jogabilidade

Entenda como mantê-los voltando ao seu jogo

A entrada do usuário permite que os usuários interajam com o ambiente da sua experiência

Guie os jogadores pela primeira vez que eles jogarem em sua experiência

Crie roupas que se esticam e se encaixam no corpo de qualquer avatar

Na Roblox, acreditamos que você aprende melhor fazendo. Escolha um de nossos guias para explorar mais do que a plataforma oferece.

Obtenha ajuda escrevendo código e respostas para suas perguntas de criação

Os serviços de Luz e Som permitem que você controle os efeitos ambientais

Mergulhe fundo na iluminação de seu ambiente e na adição de terreno.

Aprenda a adaptar seu conteúdo a diferentes idiomas e normas culturais

Programação orientada para objetos em Luau. Quando ela faz sentido?

Este guia abrange anexos, vigas e alguns conceitos básicos de escrita que te mostram como colocar a saúde do jogador como 0 se tocarem em algo

Como experimentar rapidamente com novas ideias

Cultivar uma base de jogadores ativa é uma parte fundamental do desenvolvimento de um jogo bem-sucedido e duradouro.

Learn how to use the LuauHeap tool to keep an eye on memory usage.

Aprenda sobre a otimização de desempenho e a ferramenta de solução de problemas

O Microprofiler fornece informações de tempo para o agendador de tarefas

Mergulhe fundo nas cores da moldura, nos gráficos de fogo e mais

Aprenda como os scripts de módulo funcionam e quando usá-los.

Entenda como usar métricas para ser mais bem-sucedido

Melhorar o desempenho de scripts Luau de intensidade computacional

Veja seus valores de referência diários, dicas e métricas em tempo real para levar {boldStart}{experienceName}{boldEnd} para o próximo nível.

Aprenda a usar NPCs (personagens não-jogadores) em suas experiências

@minty cria uma obby ao vivo do zero usando sugestões do chat

Nossa plataforma oferece oportunidades inigualáveis para você criar. Comece explorando a Central de Criadores, o Roblox Studio e nossa vibrante comunidade de criadores.

Nossa plataforma oferece oportunidades inigualáveis para você criar.

Nossa comunidade de estúdios premiados e criadores autodidatas começou aqui, assim como você. 

Um artista de ambiente principal na Roblox cobre como e por que usar pacotes

Aprenda a lidar com os problemas de desempenho mais comuns.

Fluxo de equipe sobre gravidade, propriedades dos materiais e restrições

Aprenda sobre o que acontece quando um usuário entra em uma experiência

Plugins adicionam funcionalidades adicionais às suas criações

Vamos passear pela Loja CGU de PolarCub! Além disso, Temprist aparece.

Aprenda a gerar tráfego e conscientização para suas criações

Obtenha todos os destaques da RDC deste ano

Saiba como vender e promover itens de avatar com informações de especialistas.

Aprenda fluxos de trabalho eficientes para criar itens de avatar em Blender.

Madison_Hatter2 mostra como texturizar e publicar um item de avatar simples.

Saiba mais sobre o que é possível com nosso motor de criação

Aprenda a implementar anúncios de vídeos recompensados em suas experiências.

Aprenda como construir um modelo de personagem humanoide R15

Faça e venda seu primeiro acessório rígido básico na Roblox

Obtenha uma prévia de alguns dos novos recursos e capacidades que estão chegando na Roblox

O Studio é a ferramenta que permite criar experiências na Roblox

Aprenda a usar o editor de scripts no Studio para criar scripts personalizados

O Andrew mostra onde colocar seus scripts, para que eles sejam executados corretamente.

O script permite adicionar interações imersivas para seus usuários

Faça e venda seu primeiro par de sapatos na Roblox.

Aprenda atalhos do Studio e comandos de tecla que tornam a construção mais rápida

Mantenha suas transições suaves mesmo quando o valor alvo for alterado.

Aprenda como integrar funcionalidades que permitem que os jogadores joguem com amizades

Aprenda a integrar recursos que permitem que jogadores joguem com conexões

Crie um anúncio patrocinado para levar sua criação para mais criadores

Quando você deve considerar usar um UnreliableRemoteEvent?

Uma olhada aprofundada em como depurar seu código no Roblox Studio.

O Studio é uma ferramenta tudo-em-um para construir na Roblox. Tente criar algo hoje!

Aprenda a oferecer benefícios recorrentes aos jogadores por uma taxa mensal

Aumente sua experiência com a ajuda de outros criadores

Use o editor de terreno para gerar e alterar o terreno no Studio

Experiências como {boldStart}{experienceName}{boldEnd} viram uma média de aumento de +8.5% em jogadas qualificadas com personalização.

Aprenda sobre os melhores métodos para marcar o tempo em experiências Roblox.

As traduções podem ajudar sua criação a alcançar muitos públicos diferentes

Visite o novo modelo de CGU Homestore com Minty e SCHLEEMPH

Use o novo Gerenciador de estilo para criar, gerenciar e aplicar estilos na interface do usuário.

Aprenda a construir para o público exclusivo da Roblox

O que são e como você pode usá-los para construir

Assista a uma introdução rápida à criação na Roblox e depois entre no Studio

Leia os anúncios mais recentes da Equipe Roblox

Gerencie e desenvolva suas criações, tudo em um lugar conveniente

A área de trabalho contém objetos que você deseja que o mecanismo renderize em seu projeto

Fluxo de equipe cobrindo peças, malhas, terreno e iluminação

Construa obbies malucos, projete pistas de corrida épicas e decore cada detalhe.
Seu mundo está aguardando! Vamos criar algo memorável.

Adicionar conteúdo da comunidade à sua experiência

Introdução à texturação para CGU com Madison_Hatter2

Users

Open Cloud APIs

Open Cloud v2

Followings

Legacy APIs

Account Information v1

Avatar v2

Avatar v1

Badges v1

Catalog v1

Contacts v1

Develop v1

Friends v1

GameJoin v1

Games v2

Games v1

Groups v2

Groups v1

Inventory v2

Inventory v1

Premium features v1

Presence v1

Translation roles v1

Users v1

Nesta página