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
-
Crie um token
Os tokens ficam no painel, em Tokens de API, e cada um tem nome e pode ser revogado individualmente.
-
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.
-
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.