Ir para o conteúdo

Criar uma API REST fake para testes

Crie endpoints JSON falsos com método, caminho, status, atraso e corpo à sua escolha, ou com dados fake gerados, servidos com CORS pelo nosso servidor para protótipos e testes.

Use :name para um parâmetro, por exemplo /users/:id

Corpo da resposta
Atraso0 ms

Textos como "{{fullName}}" ou "{{int(1, 100)}}" são substituídos a cada requisição.

itens

0 retorna um único objeto

Placeholders (36)
{{id}}
1, 2, 3… posição na lista
{{index}}
0, 1, 2… posição começando em zero
{{uuid}}
UUID v4 aleatório
{{firstName}}
Nome
{{lastName}}
Sobrenome
{{fullName}}
Nome e sobrenome
{{username}}
Nome de usuário em minúsculas
{{email}}
E-mail em example.com
{{phone}}
Número de telefone (+1 555…)
{{company}}
Nome da empresa
{{jobTitle}}
Cargo
{{street}}
Endereço
{{city}}
Cidade
{{country}}
País
{{countryCode}}
Código ISO 3166
{{zip}}
CEP de 5 dígitos
{{domain}}
domínio de exemplo
{{url}}
URL https
{{ipv4}}
IPv4 da faixa de documentação
{{color}}
Cor HEX
{{word}}
Uma palavra lorem
{{words}}
words(n): n palavras lorem
{{sentence}}
Frase lorem
{{paragraph}}
Três a cinco frases
{{int}}
int(min, max): número inteiro
{{float}}
float(min, max, decimals)
{{price}}
price(min, max): duas casas decimais
{{bool}}
true ou false
{{date}}
Data no último ano (AAAA-MM-DD)
{{datetime}}
Data e hora ISO no último ano
{{futureDate}}
Data no próximo ano
{{status}}
active, pending ou inactive
{{pick}}
pick(a, b, c): uma das opções
{{param}}
param(name): valor do caminho da URL, por exemplo :id
{{query}}
query(name): valor da query string
{{null}}
null do JSON
Cabeçalhos da resposta (opcional, somente X-)
3 / 10 endpoints · respostas JSON com CORS ativado
Processado no nosso servidor · o JSON do endpoint é mantido até você excluí-lo ou até passarem 7 dias sem nenhuma requisiçãoComo funciona

Como usar: API REST fake

  1. 1

    Descreva cada endpoint

    Escolha um método, digite um caminho como /users/:id e defina o código de status e, se quiser, um atraso para imitar uma rede lenta.

  2. 2

    Escreva a resposta

    Cole um JSON fixo ou mude para Dados fictícios e escreva um modelo com placeholders como {{fullName}} e um tamanho de lista.

  3. 3

    Crie a API mock

    Clique em Criar API mock para obter uma URL base; cada endpoint responde nessa URL mais o respectivo caminho, com CORS ativado.

  4. 4

    Chame e ajuste

    Use Testar, curl ou fetch no seu app, depois edite e salve (as mudanças valem na hora) ou exclua a API mock quando terminar.

Limites e Pro

Grátis: 10 endpoints por API mock, 100 KB por corpo e 512 KB no total, atrasos de até 5 segundos, listas geradas de até 100 itens, 120 requisições por minuto por visitante, 10 novas APIs mock por hora, exclusão após 7 dias sem requisições.

O Pro amplia os limites para 50 endpoints, corpos de 1 MB, atrasos de 30 segundos e listas de 1.000 itens. Ver o Pro

Sobre: API REST fake

A Mock REST API oferece a quem desenvolve front-end e apps móveis endpoints funcionando antes de o back-end real existir. Cada API mock tem sua própria URL base em /api/mock-api/m/, e cada endpoint que você define responde ali com o método, o caminho, o código de status, o atraso, os cabeçalhos e o corpo JSON que você escolheu. Os caminhos aceitam parâmetros, então /users/:id corresponde a /users/7, e um modelo pode devolver esse valor com {{param(id)}} ou ler a query string com {{query(name)}}.

O modo Dados fictícios transforma um modelo JSON em respostas realistas usando 36 placeholders, de nomes, e-mails, empresas e cidades a UUIDs, datas, preços, números dentro de um intervalo e texto lorem. Defina um tamanho de lista para devolver um array de até 100 itens e decida se os dados continuam iguais entre as requisições, o que serve para testes de snapshot, ou se mudam a cada vez. Códigos de status de 200 a 599 permitem ensaiar estados de erro como 401, 404, 429 e 503, e um atraso de até cinco segundos mostra como se comportam seus estados de carregamento.

As respostas são sempre JSON com cabeçalhos CORS, então navegadores de qualquer origem podem chamá-las. Uma API mock não consegue servir HTML, definir cookies nem redirecionar, não armazena as requisições que recebe e não é um banco de dados: POST e PUT respondem com o corpo que você configurou, sem salvar nada do que for enviado.

Privacidade

Para hospedar seus endpoints, as definições que você salva (métodos, caminhos, códigos de status, atrasos, cabeçalhos e corpos) são enviadas e armazenadas no nosso servidor, junto com um token de edição em hash, os horários de criação e da última requisição e a contagem de requisições. As chamadas aos seus endpoints são respondidas sem registrar corpos, cabeçalhos ou endereços IP. Uma API mock é excluída quando você a exclui ou após 7 dias sem requisição nem edição, e o token de edição fica guardado só neste navegador. Qualquer pessoa com a URL pode chamar seus endpoints, então não coloque segredos nem dados pessoais reais.

Recursos

Endpoints HTTPS reais

Qualquer método, parâmetros de caminho, códigos de status de 200 a 599, atrasos e cabeçalhos personalizados X-.

Modelos de dados fictícios

Mais de 30 placeholders para pessoas, empresas, lugares, datas, números e texto, em um objeto ou em uma lista.

Seguro desde a concepção

Só JSON, CORS ativado, sem registro de requisições, token de edição em hash, exclusão após 7 dias sem uso.

API REST fake: perguntas frequentes

O que fica armazenado no servidor e por quanto tempo?
Armazenamos as definições de endpoint que você salva, um hash SHA-256 do seu token de edição, quando a API mock foi criada e chamada pela última vez e quantas requisições ela recebeu. Não registramos corpos, cabeçalhos nem endereços IP das requisições. Cada API mock é excluída quando você clica em Excluir ou automaticamente após 7 dias sem requisição nem edição, então uma API que você continua usando permanece disponível.
Posso chamar a API mock do meu app de front-end?
Sim. Toda resposta traz Access-Control-Allow-Origin definido como *, e as requisições OPTIONS de preflight são respondidas, então fetch, axios ou qualquer cliente HTTP de navegador em qualquer domínio, inclusive localhost, consegue chamá-la. Use a URL base mais o caminho do endpoint, por exemplo fetch(base + "/users"). Apps móveis, Postman e curl também funcionam, pois os endpoints são URLs HTTPS comuns.
Como funcionam os placeholders de dados fictícios?
No modo Dados fictícios, qualquer string do seu modelo JSON que seja um placeholder, como "{{email}}" ou "{{int(1, 100)}}", é substituída quando uma requisição chega, e placeholders de número e de true ou false que ocupam a string inteira viram números e booleanos reais em JSON. Os placeholders também podem ficar dentro de um texto, como "Olá {{firstName}}". Defina um tamanho de lista para repetir o modelo, com {{id}} contando 1, 2, 3 em cada item.
Uma API mock pode devolver erros ou respostas lentas?
Sim. Escolha qualquer status de 200 a 599, como 401 Unauthorized, 404 Not Found, 422 para erros de validação, 429 Too Many Requests ou 503, e escreva o JSON de erro que seu app espera. O controle de atraso segura cada resposta por até 5 segundos no plano grátis, o que ajuda a testar indicadores de carregamento, timeouts e lógica de nova tentativa. Respostas com status 204 e 304 são enviadas sem corpo.
Por que uma API mock não pode devolver HTML nem definir cookies?
Endpoints hospedados grátis que devolvem qualquer conteúdo são uma ferramenta favorita de páginas de phishing e links de malware. Para que essas APIs mock sirvam apenas como APIs, toda resposta é application/json com nosniff e uma política de segurança de conteúdo restrita, e só são permitidos cabeçalhos personalizados que começam com X-, então elas não podem definir cookies, redirecionar navegadores nem se passar por uma página da web.