API PÚBLICA

Publique a partir de um script com a API

Uma API REST enxuta para criar sites, enviar uma publicação e consultar o resultado, com uma descrição OpenAPI para você gerar um cliente.

Plano gratuito, SSL grátis, sem cartão de crédito.

Disponibilidade por plano

Quais planos incluem acesso à API

Os tokens de API estão disponíveis a partir do plano Pro. As extensões oficiais entram de outro jeito e funcionam em todos os planos.

  • Free Não incluído
  • Starter Não incluído
  • Pro Incluído
  • Business Incluído
  • Enterprise Incluído

Esta lista vem direto dos planos usados na cobrança, então sempre corresponde ao que você recebe. Ver todos os planos e limites.

Como funciona

A mesma publicação, sem o navegador

Um token, um POST com o seu build, e o site está no ar. É o mesmo caminho de publicação do painel, com outra porta de entrada.

Você cria um token no painel e chama a API para listar seus sites, criar um novo e enviar uma publicação para ele. A resposta traz o endereço no ar e o estado da publicação, para o script poder esperar em vez de adivinhar. Tudo está descrito na referência da API e num documento OpenAPI 3.1 legível por máquina, o que basta para a maioria dos geradores criar um cliente sem você escrever nenhum.

O uso óbvio é como etapa de release: seu build roda onde já roda, e a última linha publica o resultado aqui. Isso é diferente, de propósito, de uma integração com Git. Não acompanhamos repositório nem rodamos o seu build, então nada aqui precisa de acesso ao seu código-fonte; você faz o build onde já faz e entrega a pasta para nós. Os limites de requisições são por plano e por token, então um loop descontrolado num script bate num teto, e não na sua fatura.

Como usar

Três passos

  1. Crie um token

    Os tokens ficam no painel, em Tokens de API, e cada um tem nome e pode ser revogado individualmente.

  2. Chame a API

    Crie um site, se precisar, e envie a pasta do build como uma publicação. A referência mostra as chamadas exatas.

  3. Leia o resultado

    A resposta traz o endereço no ar e o estado da publicação, para o script falhar de forma clara em vez de supor que deu certo.

Onde faz diferença

Quando vale a pena usar

Uma etapa de release no fim do build

O último comando do seu pipeline publica o resultado. Veja nos guias de build por framework o que cada ferramenta gera e onde.

Publicar relatórios gerados com hora marcada

Uma tarefa noturna que gera HTML e publica, para o mesmo endereço sempre ter os números de ontem.

Uma ferramenta sua que entrega um link para os usuários

Um gerador interno que precisa de um lugar para colocar o que produz. Publique pela API e entregue uma URL para a pessoa, em vez de um download.

A alternativa

Como fica sem a Droply

A comparação que importa não é com outra API, e sim com as plataformas baseadas em Git, que é justamente o que isto não quer ser.

  Droply Uma plataforma conectada ao Git
O que dispara a publicação A sua chamada, quando você decidir. Um push num branch monitorado.
Acesso ao seu código-fonte Nenhum. Nunca vemos o repositório. O acesso ao repositório é a própria integração.
Onde o build roda Onde ele já roda. Nos servidores deles, no ambiente deles.
Publicar sem nenhum repositório Normal. Não existe repositório no modelo. Normalmente exige outro caminho, pela CLI.
O que você envia A pasta pronta. O código-fonte, mais uma configuração de build.

Comparado ao modelo de integração com Git usado pelas plataformas para desenvolvedores, e não a um fornecedor específico. Conferido em setembro de 2026.

Quando esta não é a ferramenta certa

A API publica arquivos estáticos prontos. Não é um serviço de build nem uma API genérica de arquivos.

  • Não tem integração com Git, webhook de push nem etapa de build. Você faz o build e depois envia.
  • Ela entrega o que você envia. Não roda código no servidor, então uma API que precisa executar a sua aplicação está fora do escopo.
  • Tokens de API são um recurso pago. Se você só quer publicar a partir de um editor ou do navegador, a extensão para VS Code faz isso em todos os planos.
  • Os limites de requisições e do plano valem para as chamadas de API exatamente como valem no painel.

Perguntas frequentes

Qual plano inclui acesso à API?
Os tokens de API estão disponíveis a partir do plano Pro. Isso é separado das extensões oficiais, que entram com um código enviado por e-mail e funcionam em todos os planos, inclusive no gratuito.
Existe uma descrição OpenAPI?
Existe: OpenAPI 3.1, servida em JSON. A maioria dos geradores de cliente aceita do jeito que está, e a referência tem o link.
Posso fazer deploy pelo CI?
Pode. Esse é o uso principal. Seu build roda onde já roda, e uma chamada no final envia a pasta gerada.
Ela se conecta ao meu repositório Git?
Não, e isso não está previsto. Nunca pedimos acesso ao repositório, o que também significa que nada aqui consegue ler o seu código-fonte.
Posso revogar um token?
Pode. Os tokens ficam listados no painel, com nome, e podem ser revogados um a um, então dá para trocar o token de um job de CI sem mexer nos outros.
Existem limites de requisições?
Existem, por plano e por token, então um script que faz chamadas demais não gasta a cota de outro.

Continue explorando