Criar uma simulação

Atualizado em 29 de set. de 2026·2 min de leitura

Uma simulação nova é um contêiner com URL própria e ainda nada dentro. Criar ela não serve nada; os endpoints aparecem na URL só depois de um deploy.

Jeitos de começar

Abra Simulações e clique em Nova simulação para começar em branco, ou escolha outro ponto de partida na seta do lado:

Simulação em branco começa do zero; você adiciona os endpoints e os specs.
Simulação de exemplo já vem com o spec do Petstore e alguns endpoints estáticos. O Quickstart passa por ela.
Ver o catálogo começa por uma API curada: Stripe, Twilio, Auth0 e mais. Veja Começar pelo catálogo.
Backend é outro tipo de simulação: um provedor de pagamento ou de identidade rodando como um backend seu. Veja Criar um backend hospedado.

O seu próprio spec OpenAPI é adicionado dentro da simulação depois que ela existe, não importa por onde você começou.

Veja Subir e atualizar um spec OpenAPI.

Uma simulação também pode ir direto de um repo do GitHub, com uma URL por branch e por pull request.

Veja GitHub Action.

Nome, domínio e slug

Começar em branco abre este diálogo:

Nome é o nome que aparece nas listas. Mude quando quiser.
Domínio escolhe qual host de API a URL da simulação usa. O padrão serve.
Slug vira parte da URL: <domínio>/app/<sua-org>/<slug>. Letras minúsculas, dígitos e hífens, curto; o formulário confere a disponibilidade enquanto você digita.

O slug fica fixo a partir do primeiro deploy, para as URLs públicas continuarem estáveis.

Uma simulação conta na cota do seu plano desde a hora em que é criada, com deploy feito ou não. Excluir ela libera a vaga.

Depois de criar

A simulação abre na visão de Endpoints. Ela ainda não serve nada: dê forma ao que ela deve responder e depois clique em Fazer deploy para colocar ela no ar na URL dela.

Veja Deploy e URLs.