Se você está construindo uma interface de usuário antes que o backend exista, você precisa de dados para renderizar, e o DummyJSON é uma das maneiras mais rápidas de obtê-los. É uma API REST falsa e gratuita, hospedada, que serve produtos, usuários, carrinhos de compras e muito mais, de forma realista, via HTTP simples, sem necessidade de cadastro. Este guia explica o que o DummyJSON oferece, como ele se compara a outras APIs públicas de teste, e o que fazer quando dados fixos de placeholder deixam de ser suficientes.
O que é DummyJSON?
DummyJSON é uma API JSON de placeholder gratuita. Você envia uma requisição para um endpoint público, e ele retorna dados de exemplo estruturados e críveis. Não há banco de dados para configurar e nenhuma chave para registrar. Ele existe para que desenvolvedores frontend, estudantes e qualquer pessoa que esteja prototipando possam acessar um endpoint de rede real em vez de codificar arrays em seu código.
Os dados são falsos, mas coerentes. Um produto tem título, preço, classificação, contagem de estoque e categoria. Um usuário tem nome, e-mail, endereço e empresa. Essa consistência torna o DummyJSON útil para conectar tabelas, cartões, paginação e páginas de detalhes que se parecem com a realidade. Como os registros são aninhados e tipados da maneira que os dados de produção geralmente são, você pode construir filtros, controles de ordenação e visualizações de detalhes sem precisar inventar seus próprios dados primeiro.
O DummyJSON serve tudo via HTTPS como JSON, então funciona da mesma forma a partir de um `fetch` do navegador, um aplicativo móvel, um comando curl ou um script do lado do servidor. Não há nada para instalar. Você aponta uma requisição para uma URL e recebe dados de volta, o que é exatamente o que você quer nas primeiras horas de um projeto quando a API real ainda não existe.
É uma ferramenta de aprendizado e prototipagem, e é boa nisso. Quando você precisa de um endpoint para buscar em um tutorial ou uma demonstração rápida, ele economiza um tempo real.
Endpoints, autenticação e limites do DummyJSON
O DummyJSON expõe várias coleções de recursos. As mais comuns são:
/products, itens de catálogo com preço, estoque e classificações/users, pessoas com endereços, e-mails e detalhes da empresa/carts, carrinhos de compras vinculados a usuários/postse/comments, conteúdo estilo blog/todos, itens de tarefa/recipese/quotes, conjuntos de conteúdo extras
Cada coleção suporta os padrões que você esperaria de uma API REST. Você pode buscar todos os registros, buscar um por ID, pesquisar, filtrar por categoria e paginar com limit e skip. Um parâmetro select corta a resposta para campos específicos, e um parâmetro delay (0 a 5000 ms) permite simular uma rede lenta para que você possa testar estados de carregamento.
Aqui está uma leitura básica:
curl https://dummyjson.com/products?limit=5&skip=10
A autenticação usa um endpoint de login e um token de portador (bearer token). Você envia credenciais para /auth/login, recebe um token de volta e o envia em requisições protegidas:
# 1. Faça login para obter um token
curl -X POST https://dummyjson.com/auth/login \
-H 'Content-Type: application/json' \
-d '{"username":"emilys","password":"emilyspass"}'
# 2. Use o token em uma requisição autenticada
curl https://dummyjson.com/auth/me \
-H 'Authorization: Bearer SEU_TOKEN_DE_ACESSO_AQUI'
Escritas também são suportadas. Você pode enviar requisições POST, PUT, PATCH e DELETE, e a API responde como se a alteração tivesse ocorrido. O porém: essas escritas são simuladas. O DummyJSON retorna um registro que parece atualizado ou criado, mas nada persiste. Recarregue e seu "novo" produto terá desaparecido. Isso é por design para um serviço público compartilhado, e é o limite mais importante a ser compreendido. A documentação não publica limites de taxa rígidos, mas trate qualquer endpoint compartilhado gratuito com cuidado e não direcione um teste de carga para ele.
Para um tour mais completo sobre o que existe além do DummyJSON, o resumo de APIs gratuitas para desenvolvedores abrange opções em muitas categorias.
DummyJSON vs JSONPlaceholder vs Reqres
DummyJSON não é a única API REST falsa e gratuita. As duas com as quais ele é mais comparado são JSONPlaceholder e Reqres. Elas se sobrepõem, mas cada uma pende para um lado diferente.
| Ferramenta | Melhor para | Recursos | Fluxo de autenticação | Gravações persistem? |
|---|---|---|---|---|
| DummyJSON | Demonstrações realistas no estilo e-commerce | Produtos, usuários, carrinhos, posts, receitas, mais | Endpoint de login + token de portador | Não (simulado) |
| JSONPlaceholder | Tutoriais CRUD rápidos, configuração mínima | Posts, comentários, usuários, tarefas, álbuns, fotos | Nenhum | Não (simulado) |
| Reqres | Demonstrações de fluxo de autenticação e requisição/resposta | Usuários, mocks de registro/login | Mock de registro/login | Não (simulado) |
O padrão é o mesmo em todas as três. Você obtém dados fixos, predominantemente de leitura, as escritas são falsificadas e você não pode alterar a forma do que é retornado. O JSONPlaceholder funciona com json-server por baixo dos panos, por isso seu modelo de dados parece tão genérico. O DummyJSON ganha quando você quer dados que se assemelham a uma loja real. O Reqres é útil quando você está demonstrando especificamente uma tela de login.
As fontes oficiais valem a pena serem adicionadas aos favoritos: JSONPlaceholder e o repositório GitHub do DummyJSON se você quiser auto-hospedar ou ler o código.
Quando dados fixos de placeholder não são suficientes
APIs falsas hospedadas atingem um limite rapidamente assim que seu projeto se torna específico. Você sentirá isso quando:
- Seu aplicativo precisar de campos que o DummyJSON não possui. Um
subscription_tierou um objetofeature_flagssimplesmente não está no esquema, e você não pode adicioná-lo. - Você precisar de gravações que persistam. Construir um fluxo de carrinho ou um painel de administração significa criar um registro e lê-lo de volta. Gravações simuladas quebram esse ciclo.
- Você precisar testar caminhos de erro. Um aplicativo real deve lidar com um
429, um500ou uma carga malformada. APIs de sucesso fixo não produzirão isso sob demanda. - Seus dados devem corresponder ao seu próprio contrato OpenAPI para que o frontend e o backend concordem antes que o servidor real seja lançado.
Este é o ponto em que você para de pegar emprestado a API falsa de outra pessoa e começa a gerar a sua própria. Você quer a mesma conveniência de zero backend, mas com seu esquema, seus nomes de campo e respostas que você controla.
Como construir sua própria API REST falsa personalizada com Apidog
Apidog é uma plataforma de API que projeta, testa, documenta e simula APIs em um só lugar. Seu servidor de mock é a peça que substitui uma API falsa hospedada quando você superou os dados fixos. Em vez de aceitar o que o DummyJSON retorna, você define o endpoint e a forma dos dados, e o Apidog gera respostas realistas que correspondem. Para acompanhar, baixe o Apidog e crie um projeto gratuito.
Aqui está o fluxo:
1. Defina seu endpoint e esquema. Crie um endpoint como GET /products e descreva os campos de resposta: id, title, price, stock, category. Você pode fazer isso manualmente ou importar um arquivo OpenAPI/Swagger existente para que o mock corresponda ao seu contrato real.
2. Deixe o mock inteligente gerar os dados. O Apidog lê seus nomes de campo e tipos, e então produz valores sensatos automaticamente. Um campo chamado email retorna um e-mail, price retorna um número, createdAt retorna uma data. Não há necessidade de escrever dados de teste manualmente. Se você já usou o Faker, esta é a mesma ideia integrada à plataforma. O guia sobre geração de dados mock a partir de esquemas OpenAPI detalha o lado impulsionado por esquema.
3. Personalize valores e casos extremos. Precisa de um intervalo específico para price, um enum fixo para status ou uma resposta 500 deliberada para testar o tratamento de erros? Você define regras por campo e por resposta. Esta é a parte que as APIs hospedadas não conseguem fazer, porque você é o proprietário da definição.
4. Execute o servidor de mock e chame-o. O Apidog fornece uma URL ao vivo. Aponte seu frontend para ela exatamente como você apontaria para o DummyJSON, exceto que agora cada campo e código de status são seus:
curl https://<seu-host-mock>/products?limit=5
Como o mock é gerado a partir do seu esquema, quando sua especificação de API muda, o mock muda com ela. Seus dados falsos e seu contrato real nunca se desviam. Se você quiser conjuntos de dados mais realistas e variados, a abordagem em criação de dados de teste de API realistas combina bem com o desenvolvimento orientado a mocks.
A troca honesta: o DummyJSON ganha em velocidade para uma demonstração descartável, já que não há nada para configurar. O Apidog ganha no momento em que você precisa do seu próprio esquema, gravações com sensação de persistência, erros controláveis ou um mock que permanece sincronizado com a API real que você vai lançar.
Perguntas Frequentes
O DummyJSON é gratuito?
Sim. O DummyJSON é gratuito e não precisa de chave de API. Você pode chamar seus endpoints públicos diretamente de um navegador, curl ou seu aplicativo. Como qualquer serviço gratuito compartilhado, ele é destinado a prototipagem e aprendizado, não a tráfego de produção ou teste de carga.
O DummyJSON salva os dados que eu crio ou atualizo?
Não. Requisições POST, PUT, PATCH e DELETE retornam uma resposta que parece bem-sucedida, mas nada persiste no servidor. A próxima leitura retorna os dados originais. Quando você precisar de gravações que realmente persistam, construa seu próprio mock. O guia de APIs mock explica a diferença entre mocking simulado e com estado.
Qual a diferença entre DummyJSON e um servidor de mock?
DummyJSON é um conjunto de dados fixo e hospedado que todos compartilham. Um servidor de mock, como o do Apidog, roda com base no seu esquema e retorna dados e códigos de status que você define. Use DummyJSON para demos genéricas, e um servidor de mock quando os dados precisam corresponder à sua própria API.
Posso obter dados realistas em vez de placeholders óbvios?
Sim, se você gerá-los a partir de um esquema. Ferramentas baseadas em esquema leem seus nomes de campo e tipos e produzem valores críveis automaticamente, então um campo email se parece com um e-mail e um price se parece com um preço. Essa é a principal razão pela qual as equipes passam de uma API falsa fixa para seu próprio mock.
Conclusão
DummyJSON é uma sólida API REST falsa e gratuita. É a maneira mais rápida de renderizar uma interface de usuário com produtos, usuários e carrinhos de compras de aparência realista, sem escrever uma linha de código de backend, e para tutoriais ou protótipos rápidos é difícil de superar. Os limites aparecem quando você precisa de seus próprios campos, escritas que persistem, erros controláveis ou dados que acompanham seu contrato de API.
Quando você chegar a esse ponto, gere sua própria API REST falsa personalizada em vez de pegar emprestado uma fixa. O Apidog permite que você defina o esquema, simule dados realistas a partir dele automaticamente e mantenha o mock sincronizado com a API que você vai lançar. Experimente gratuitamente e transforme sua especificação em um mock funcional em minutos.